Main Page

Gothic 1 Remake Multiplayer

G1R:MP Scripting Wiki

Build multiplayer resources and gamemodes with Lua 5.1. This wiki documents the server, client, networking, gameplay, database, and RmlUi APIs exposed by G1R:MP.

Lua 5.1 • server and client resources • authoritative gameplay • RmlUi

Current public release: G1R:MP 0.1.9 / BUILD264 / Protocol 42. Windows client and Windows/Linux dedicated servers are available on the Download page. Update both client and server; Protocol 41 and older cannot join. See Update 0.1.9 for changes and compatibility notes.

New in 0.1.9. See the guides below for APIs, examples and scope.

• Server-controlled item statistics, jewelry/consumables/rune settings and positive-mana casting recovery.
• Armor bases, upgrade pieces and full sets; corrected female identities.
• 844 added activity aliases and fishing (962 total), with the complete list.
• 94 editor prefabs, original-world inspection/removal, shared placed doors and custom native keys with server APIs/callbacks.
• Crafting-window visibility and extended weather with the 43-setting catalog.
• Optional Discord Rich Presence: eight server Lua functions, status callback and server-owner configuration, from 0.1.9.

See each guide for availability, current limits and remaining visual qualification.

Also available from 0.1.9: armor upgrade slots and full sets, with the 26-base catalog, 84-part catalog and eight server Lua functions.

Also available since 0.1.8. Character dimensions for players, NPCs and monsters: six server-side Lua functions, three events and private character-creator examples. Also includes UI rendering fixes and automatic completion of multiplayer loading screens when loading is finished.

Also available (since 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.

Start here

Find the right entry point for your first resource.

• 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)
• Interactive seats and lights (since 0.1.9)
• Item statistics and armor protection (since 0.1.9)
• 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
• Character dimensions and private creators (since 0.1.8)
• 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

Reference by execution side

Check where a function is available before using it.

• Server-side functions
• Client-side functions
• Audio functions (client / server)
• Shared functions
• Server-side events
• Client-side events
• Event functions
• Network functions

Gameplay

Players

Position and spawn

Progression

Inventory

Equipment

Magic

Health and life state

World time and weather

Monsters

AI navigation

Interactions

Scripting systems

RmlUi and GUI

Database

Connection recovery (0.1.4)

Timers

Commands

Chat

Animations

Client audio and OGG playback

Camera

Events and callbacks

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.

Community

• G1R:MP website
• Community forum
• Project lead: QCherry

Documentation status

Browse functions and events by topic above. Each API page identifies its version and execution side. See Update 0.1.9 for the current release and Update 0.1.8 for the previous release. APIs marked experimental may change. Historical release notices remain on their dedicated reference pages.