add Makefile for standalone visual/debug builds, document visual mode in README

Author: valtterivalo

pufferlib/ocean/osrs_pvp/Makefile

@@ -0,0 +1,43 @@
+# OSRS PvP C Environment Makefile
+#
+# standalone targets (no PufferLib dependency):
+#   make           — headless benchmark binary
+#   make visual    — headed raylib viewer with human input
+#   make debug     — debug build with sanitizers
+#
+# PufferLib training uses setup.py build_osrs_pvp instead.
+
+CC = clang
+CFLAGS = -Wall -Wextra -O3 -ffast-math -flto -fPIC -std=c11
+DEBUG_FLAGS = -Wall -Wextra -g -O0 -fPIC -std=c11 -DDEBUG
+LDFLAGS = -lm
+
+TARGET = osrs_pvp
+DEMO_SRC = osrs_pvp.c
+HEADERS = osrs_pvp.h
+
+# Raylib (for visual target). download from https://github.com/raysan5/raylib/releases
+RAYLIB_DIR = raylib-5.5_macos
+UNAME_S := $(shell uname -s)
+ifeq ($(UNAME_S),Darwin)
+RAYLIB_FLAGS = -I$(RAYLIB_DIR)/include $(RAYLIB_DIR)/lib/libraylib.a \
+               -framework Cocoa -framework OpenGL -framework IOKit -framework CoreVideo
+else
+RAYLIB_FLAGS = -I$(RAYLIB_DIR)/include -L$(RAYLIB_DIR)/lib -lraylib -lGL -lpthread -ldl -lrt
+endif
+
+.PHONY: all clean debug visual
+
+all: $(TARGET)
+
+$(TARGET): $(DEMO_SRC) $(HEADERS)
+	$(CC) $(CFLAGS) -o $@ $(DEMO_SRC) $(LDFLAGS)
+
+visual: $(DEMO_SRC) $(HEADERS) osrs_pvp_render.h osrs_pvp_gui.h
+	$(CC) $(CFLAGS) -DOSRS_PVP_VISUAL $(RAYLIB_FLAGS) -o $(TARGET)_visual $(DEMO_SRC) $(LDFLAGS)
+
+debug: $(DEMO_SRC) $(HEADERS)
+	$(CC) $(DEBUG_FLAGS) -o $(TARGET)_debug $(DEMO_SRC) $(LDFLAGS)
+
+clean:
+	rm -f $(TARGET) $(TARGET)_debug $(TARGET)_visual *.o

pufferlib/ocean/osrs_pvp/README.md

@@ -13,6 +13,20 @@ Zulrah encounter is a separate env that shares headers with osrs_pvp:
 python setup.py build_osrs_zulrah --inplace --force
 ```
 
+## Visual mode
+
+Standalone headed viewer with raylib. supports human play, AI observation, and encounter selection.
+
+```bash
+cd pufferlib/ocean/osrs_pvp
+make visual
+./osrs_pvp_visual --visual                      # PvP (watch AI vs scripted opponent)
+./osrs_pvp_visual --visual --encounter zulrah   # Zulrah
+./osrs_pvp_visual --visual --human              # human control (click to move/attack)
+```
+
+requires raylib 5.5 — download from https://github.com/raysan5/raylib/releases and extract to `raylib-5.5_macos/` (or adjust `RAYLIB_DIR` in Makefile for linux).
+
 ## Data assets
 
 Not in git. Exported from the OSRS game cache: