Main Page: Difference between revisions
Jump to navigation
Jump to search
Document upcoming 0.1.7: optional server TTS, 33 functions, 4 events, English voice/setup guides and NPC meleeSkillTier; not a release |
Release 0.1.7 / BUILD199 / Protocol 39: current API availability, setup and improvements |
||
| Line 9: | Line 9: | ||
<div style="border:1px solid #b28a3d; border-left:4px solid #b28a3d; background:#faf9f5; padding:0.9rem 1rem; margin:0 0 1.2rem;"> | <div style="border:1px solid #b28a3d; border-left:4px solid #b28a3d; background:#faf9f5; padding:0.9rem 1rem; margin:0 0 1.2rem;"> | ||
'''Current public release: G1R:MP 0.1. | '''Current public release: G1R:MP 0.1.7 / BUILD199 / Protocol 39.''' Windows client and Windows/Linux dedicated server downloads are available on the [https://g1r-mp.com/download/ Download page]. Update both the client and server. See [[Update 0.1.7]] for scripting additions and migration notes. Protocol 38 and older clients/servers are not compatible with this release. | ||
</div> | </div> | ||
<!-- g1r-upcoming017-game-audio:start --> | <!-- g1r-upcoming017-game-audio:start --> | ||
<div style="border:1px solid #b89a50; padding:0.85rem 1rem; margin:1rem 0;"> | <div style="border:1px solid #b89a50; padding:0.85rem 1rem; margin:1rem 0;"> | ||
''' | '''New in [[Update 0.1.7|0.1.7]].''' [[Game audio|Built-in game audio]]: 11 client functions and a result event. [[Server TTS|Optional server TTS]]: 33 server functions and 4 events, reusable recordings and remote 3D/NPC speech. English guides: [[TTS configuration|Windows/Linux setup]] and [[TTS voices|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. | ||
</div> | </div> | ||
<!-- g1r-upcoming017-game-audio:end --> | <!-- g1r-upcoming017-game-audio:end --> | ||
| Line 20: | Line 20: | ||
<!-- upcoming016:start --> | <!-- upcoming016:start --> | ||
<div style="border:1px solid #6f8461; background:#f5f8f2; padding:0.9rem 1rem; margin-bottom:1.2rem;"> | <div style="border:1px solid #6f8461; background:#f5f8f2; padding:0.9rem 1rem; margin-bottom:1.2rem;"> | ||
''' | '''Also included (since [[Update 0.1.6|0.1.6]]).''' Four new server-side functions: [[Area notifications|custom area notifications]] and [[Mounts|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. | ||
</div> | </div> | ||
<!-- upcoming016:end --> | <!-- upcoming016:end --> | ||
| Line 44: | Line 44: | ||
<li>[[NPC and monster navigation collision|NPC and monster navigation collision]]</li> | <li>[[NPC and monster navigation collision|NPC and monster navigation collision]]</li> | ||
<li>[[Client audio|Client audio and synchronized 3D playback]]</li> | <li>[[Client audio|Client audio and synchronized 3D playback]]</li> | ||
<li>[[Game audio|Built-in game audio ( | <li>[[Game audio|Built-in game audio (since 0.1.7)]]</li> | ||
<li>[[Game dialogue catalog|Complete dialogue catalog ( | <li>[[Game dialogue catalog|Complete dialogue catalog (since 0.1.7)]]</li> | ||
<li>[[Server TTS|Server TTS ( | <li>[[Server TTS|Server TTS (since 0.1.7)]] — [[TTS configuration|setup]] · [[TTS voices|voice samples and presets]]</li> | ||
<li>[[Scripted camera|Scripted camera and moving login backgrounds]]</li> | <li>[[Scripted camera|Scripted camera and moving login backgrounds]]</li> | ||
<li>[[Map editor|Map editor: controls, save and reopen (0.1.4)]]</li> | <li>[[Map editor|Map editor: controls, save and reopen (0.1.4)]]</li> | ||
| Line 141: | Line 141: | ||
<div style="flex:1 1 22rem; border-top:3px solid #6f8461; background:#f5f2e9; padding:1rem 1.15rem;"> | <div style="flex:1 1 22rem; border-top:3px solid #6f8461; background:#f5f2e9; padding:1rem 1.15rem;"> | ||
<div style="font-size:1.2rem; font-weight:bold; margin-bottom:0.4rem;">Documentation status</div> | <div style="font-size:1.2rem; font-weight:bold; margin-bottom:0.4rem;">Documentation status</div> | ||
<div style="line-height:1.6;">Browse functions and events by topic above. Each API page identifies its version and execution side. See [[Update 0.1. | <div style="line-height:1.6;">Browse functions and events by topic above. Each API page identifies its version and execution side. See [[Update 0.1.7]] for the current release and [[Update 0.1.6]] for the previous release. APIs marked [[:Category:Experimental Lua API|experimental]] may change. Historical release notices remain on their dedicated reference pages.</div> | ||
</div> | </div> | ||
</div> | </div> | ||
[[Category:Lua API]] | [[Category:Lua API]] | ||
Revision as of 23:51, 10 October 2026
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.7 / BUILD199 / Protocol 39. Windows client and Windows/Linux dedicated server downloads are available on the Download page. Update both the client and server. 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. 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
- 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
Reference by execution side
Check where a function is available before using it.
Gameplay
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.
Documentation status
Browse functions and events by topic above. Each API page identifies its version and execution side. See Update 0.1.7 for the current release and Update 0.1.6 for the previous release. APIs marked experimental may change. Historical release notices remain on their dedicated reference pages.