Main Page
Current public release: G1R:MP 0.1.7 / client BUILD202 / Protocol 39. Windows client and Windows/Linux dedicated server downloads are available on the Download page. When upgrading from an earlier version, update both the client and server. Existing 0.1.7 / Protocol 39 servers remain compatible with client BUILD202. See Update 0.1.7 for scripting additions and migration notes. Protocol 38 and older clients/servers are not compatible with this release.
New in 0.1.7. Native HUD and menus: 5 client Lua functions and a result event, resource-owned HUD/menu control and multiplayer save/load protection. Built-in game audio: 11 client functions and a result event. Optional server TTS: 33 server functions and 4 events, reusable recordings and remote 3D/NPC speech. English guides: Windows/Linux setup and own/downloaded voice samples and presets. Also: NPC crowd optimizations, melee skill tiers, remote acrobatics, climbing/ladder transitions, torch synchronization, identity accessory and gate-streaming fixes.
Also included (since 0.1.6). Four new server-side functions: custom area notifications and player-owned rideable scavengers. Also includes mounted nameplate/recovery fixes, smoother ordinary doors and pickup performance/animation improvements. See the guides for remaining in-game validation.
Also included (since 0.1.5). NPC combat and scripting, walk/run pursuit, identity, skin colour, tattoos, player weapon modes and events. Also includes crouch synchronization, melee presentation and knockdown recovery improvements.
Also included (since 0.1.4). See MySQL connection recovery, Weapon control, Mouse capture, UpdateCameraPose, Map editor, World objects and 118 player animations for released tools and scripting APIs. Also see WebP images, os.time and remote event security.
- Lua API overview
- Complete function catalog
- Complete event and callback catalog
- Lua, resource and API limits
- Validated skin, monster, equipment, and gameplay keys
- NPC and monster navigation collision
- Client audio and synchronized 3D playback
- Built-in game audio (since 0.1.7)
- Complete dialogue catalog (since 0.1.7)
- Server TTS (since 0.1.7) — setup · voice samples and presets
- Native HUD/menu control and custom key bindings
- Scripted camera and moving login backgrounds
- Map editor: controls, save and reopen (0.1.4)
- Load exported objects for players (0.1.4)
- Player animations: work, sitting, sleep and gestures (expanded in 0.1.4)
- Identity, skin color and tattoos
- Custom chapter title cards
- Custom area notifications (since 0.1.6)
- Rideable scavengers and ownership (since 0.1.6)
- Observer-specific labels and acquaintance presentation
- Resource lifecycle functions
- Lua examples
- Hosting a dedicated server
- Known issues and GPU crash workarounds
- Experimental API status
Your first server script
The following example welcomes a joining player and places them at an authoritative spawn point:
addEventHandler("onPlayerJoin", root, function(playerId)
setPlayerName(playerId, "Newcomer")
spawnPlayer(playerId, 12.0, 24.0, 2.0, 90)
outputChatBox("Welcome to G1R:MP!", playerId, 225, 195, 110)
end)
See onPlayerJoin, addEventHandler, setPlayerName, spawnPlayer, and outputChatBox for parameter details and additional examples.