Wiki G1R-MP G1 Remake Multiplayer - Recent changes [en]

Main Page

QCherry — Tue, 20 Oct 2026 13:30:30 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:30, 20 October 2026
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.8 / ~~BUILD210~~ / Protocol 40.''' Windows client and Windows/Linux dedicated servers are available on the [https://g1r-mp.com/download/ Download page]. Update both client and server; Protocol 39 and older cannot join. See [[Update 0.1.8]] for changes and compatibility notes.		'''Current public release: G1R:MP 0.1.9 / BUILD264 / Protocol 42.''' Windows client and Windows/Linux dedicated servers are available on the [https://g1r-mp.com/download/ Download page]. Update both client and server; Protocol 41 and older cannot join. See [[Update 0.1.9]] for changes and compatibility notes.
	</div>		</div>

	<!-- upcoming019:start -->		<!-- upcoming019: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;">
	'''~~Coming~~ in [[Update 0.1.9\|0.1.9]] ~~— not yet publicly released~~.''' ~~Public 0.1.8 remains~~ the ~~current release~~.		'''New in [[Update 0.1.9\|0.1.9]].''' See the guides below for APIs, examples and scope.
	* [[Item type stats\|Server-controlled item statistics]], jewelry/consumables/rune settings and positive-mana casting recovery.		* [[Item type stats\|Server-controlled item statistics]], jewelry/consumables/rune settings and positive-mana casting recovery.
	* [[Armor upgrades\|Armor bases, upgrade pieces and full sets]]; [[Female identities\|corrected female identities]].		* [[Armor upgrades\|Armor bases, upgrade pieces and full sets]]; [[Female identities\|corrected female identities]].
Line 21:		Line 21:
	* [[Native crafting UI\|Crafting-window visibility]] and [[Weather\|extended weather]] with the [[Weather catalog\|43-setting catalog]].		* [[Native crafting UI\|Crafting-window visibility]] and [[Weather\|extended weather]] with the [[Weather catalog\|43-setting catalog]].
	* [[Discord Rich Presence\|Optional Discord Rich Presence]]: eight server Lua functions, status callback and [[Discord Presence configuration\|server-owner configuration]], from 0.1.9.		* [[Discord Rich Presence\|Optional Discord Rich Presence]]: eight server Lua functions, status callback and [[Discord Presence configuration\|server-owner configuration]], from 0.1.9.
	See each guide for availability, current limits and remaining visual qualification~~. Documentation publication is not a client/server release~~.		See each guide for availability, current limits and remaining visual qualification.
	</div>		</div>
	<!-- upcoming019:end -->		<!-- upcoming019:end -->
	[[Armor upgrades\|Also ~~planned for~~ 0.1.9: armor upgrade slots and full sets]], with the [[Armor catalog\|26-base catalog]], [[Armor upgrade catalog\|84-part catalog]] and eight server Lua functions.		[[Armor upgrades\|Also available from 0.1.9: armor upgrade slots and full sets]], with the [[Armor catalog\|26-base catalog]], [[Armor upgrade catalog\|84-part catalog]] and eight server Lua functions.


	<!-- dimensions018:start -->		<!-- dimensions018: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;">
	'''~~New in~~ [[Update 0.1.8\|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 [[Update 0.1.8\|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.
	</div>		</div>
	<!-- dimensions018:end -->		<!-- dimensions018:end -->
Line 71:		Line 71:
	<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>
	<li>[[Interactive map objects\|Interactive seats and lights (~~planned~~ 0.1.9)]]</li>		<li>[[Interactive map objects\|Interactive seats and lights (since 0.1.9)]]</li>
	<li>[[Item type stats\|Item statistics and armor protection (~~planned~~ 0.1.9)]]</li>		<li>[[Item type stats\|Item statistics and armor protection (since 0.1.9)]]</li>
	<li>[[Map scene deployment\|Load exported objects for players (0.1.4)]]</li>		<li>[[Map scene deployment\|Load exported objects for players (0.1.4)]]</li>
	<li>[[Player animation catalog\|Player animations: work, sitting, sleep and gestures (expanded in 0.1.4)]]</li>		<li>[[Player animation catalog\|Player animations: work, sitting, sleep and gestures (expanded in 0.1.4)]]</li>
Line 166:		Line 166:
	<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.8]] for the current release and [[Update 0.1.7]] for the previous release. APIs marked [[:Category:Experimental Lua API\|experimental]] may change. Historical release notices remain on their dedicated reference pages.</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.9]] for the current release and [[Update 0.1.8]] 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]]

WorldObjects.request

QCherry — Tue, 20 Oct 2026 13:30:23 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:30, 20 October 2026
Line 17:		Line 17:
	<!-- worldmodels019:start -->		<!-- worldmodels019:start -->
	== Original world model operations from 0.1.9 ==		== Original world model operations from 0.1.9 ==
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~. Use matching updated clients and server.'''		'''Available from 0.1.9. Use matching updated clients and server.'''

	[[World model removal#Developer API and diagnostics\|World model removal]] documents world_pick, world_nearby, world_select, world_set and world_restore_all, layer ownership and result handling. Existing create/delete operations still concern the caller's own static objects. Original-world hiding is reversible and does not edit terrain or NPC obstacle maps. A native live layer is not server authorization/replication: use trusted server state and the supplied editor/deployment workflow. Shared placed doors instead use server [[setWorldDoors]].		[[World model removal#Developer API and diagnostics\|World model removal]] documents world_pick, world_nearby, world_select, world_set and world_restore_all, layer ownership and result handling. Existing create/delete operations still concern the caller's own static objects. Original-world hiding is reversible and does not edit terrain or NPC obstacle maps. A native live layer is not server authorization/replication: use trusted server state and the supplied editor/deployment workflow. Shared placed doors instead use server [[setWorldDoors]].
	<!-- worldmodels019:end -->		<!-- worldmodels019:end -->

World objects

QCherry — Tue, 20 Oct 2026 13:30:20 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:30, 20 October 2026
Line 94:		Line 94:
	<!-- worldmodels019:start -->		<!-- worldmodels019:start -->
	== Original world model operations from 0.1.9 ==		== Original world model operations from 0.1.9 ==
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~. Use matching updated clients and server.'''		'''Available from 0.1.9. Use matching updated clients and server.'''

	[[World model removal#Developer API and diagnostics\|World model removal]] documents world_pick, world_nearby, world_select, world_set and world_restore_all, layer ownership and result handling. Existing create/delete operations still concern the caller's own static objects. Original-world hiding is reversible and does not edit terrain or NPC obstacle maps. A native live layer is not server authorization/replication: use trusted server state and the supplied editor/deployment workflow. Shared placed doors instead use server [[setWorldDoors]].		[[World model removal#Developer API and diagnostics\|World model removal]] documents world_pick, world_nearby, world_select, world_set and world_restore_all, layer ownership and result handling. Existing create/delete operations still concern the caller's own static objects. Original-world hiding is reversible and does not edit terrain or NPC obstacle maps. A native live layer is not server authorization/replication: use trusted server state and the supplied editor/deployment workflow. Shared placed doors instead use server [[setWorldDoors]].
	<!-- worldmodels019:end -->		<!-- worldmodels019:end -->

World model removal

QCherry — Tue, 20 Oct 2026 13:30:18 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:30, 20 October 2026
Line 1:		Line 1:
	= World model removal =		= World model removal =
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released)~~.''' The [[Map editor]] can inspect and reversibly hide supported original world objects, then publish a saved removal set to players. This does not destructively edit the installed map.		'''Available from 0.1.9.''' The [[Map editor]] can inspect and reversibly hide supported original world objects, then publish a saved removal set to players. This does not destructively edit the installed map.

	== Inspect and select ==		== Inspect and select ==

World door prefab catalog

QCherry — Tue, 20 Oct 2026 13:30:17 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:30, 20 October 2026
Line 1:		Line 1:
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~. Use matching updated server and clients.'''		'''Available from 0.1.9. Use matching updated server and clients.'''

	7 approved door aliases for [[setWorldDoors]]. Query [[getWorldDoorPrefabs]] for the running server. Each uses original native scale and collision; this is not the static mesh catalog. Not every alias has individual in-game visual qualification.		7 approved door aliases for [[setWorldDoors]]. Query [[getWorldDoorPrefabs]] for the running server. Each uses original native scale and collision; this is not the static mesh catalog. Not every alias has individual in-game visual qualification.

Weather catalog

QCherry — Tue, 20 Oct 2026 13:30:16 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:30, 20 October 2026
Line 1:		Line 1:
	= Weather catalog =		= Weather catalog =
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~. Use matching updated clients and server.'''		'''Available from 0.1.9. Use matching updated clients and server.'''

	All 43 canonical settings exposed by [[getWeatherTypes]] in 0.1.9: five original biome-aware modes and 38 explicit game presets. See [[Weather]] for Lua, configuration, synchronization and qualification. A catalog entry is not individual in-game visual certification.		All 43 canonical settings exposed by [[getWeatherTypes]] in 0.1.9: five original biome-aware modes and 38 explicit game presets. See [[Weather]] for Lua, configuration, synchronization and qualification. A catalog entry is not individual in-game visual certification.

Weather

QCherry — Tue, 20 Oct 2026 13:30:14 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:30, 20 October 2026
Line 1:		Line 1:
	= Weather =		= Weather =
	'''Extended presets and getWeatherTypes are available from 0.1.9 ~~(upcoming; not yet publicly released)~~.''' Existing weather/time functions remain available in earlier releases with their earlier catalog~~. Public 0.1.8 does not support the new presets~~. Use matching updated server and clients.		'''Extended presets and getWeatherTypes are available from 0.1.9.''' Existing weather/time functions remain available in earlier releases with their earlier catalog. Use matching updated server and clients.

	== Available weather ==		== Available weather ==

ValidateWorldDoors

QCherry — Tue, 20 Oct 2026 13:30:13 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:30, 20 October 2026
Line 1:		Line 1:
	= validateWorldDoors =		= validateWorldDoors =
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~. Use matching updated server and clients.'''		'''Available from 0.1.9. Use matching updated server and clients.'''

	Server Lua. Part of [[Custom keys\|custom keys and shared placed doors]].		Server Lua. Part of [[Custom keys\|custom keys and shared placed doors]].

UpdatePlayerDiscordPresence

QCherry — Tue, 20 Oct 2026 13:30:11 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:30, 20 October 2026
Line 1:		Line 1:
	= updatePlayerDiscordPresence =		= updatePlayerDiscordPresence =
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~. Use matching updated clients and server.'''		'''Available from 0.1.9. Use matching updated clients and server.'''

	'''Server-side only.''' Part of [[Discord Rich Presence]]. See [[Discord Presence configuration]] for the optional server-owner resource.		'''Server-side only.''' Part of [[Discord Rich Presence]]. See [[Discord Presence configuration]] for the optional server-owner resource.

Update 0.1.9

QCherry — Tue, 20 Oct 2026 13:30:10 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:30, 20 October 2026
Line 1:		Line 1:
	= Update 0.1.9 =		= Update 0.1.9 =
	'''~~Upcoming / in development — not yet publicly released.''' This page documents implemented additions targeted for '''~~0.1.9'''~~, including experimental features~~ and ~~their current boundaries~~. ~~Public 0.1.8 remains the released~~ download. ~~This is documentation, not a release announcement or a~~ client/server ~~deployment~~.		'''Released: G1R:MP 0.1.9 / BUILD264 / Protocol 42.''' The Windows client and Windows/Linux dedicated servers are available on the [https://g1r-mp.com/download/ Download page]. Update both client and server. Experimental features and remaining qualification limits are identified below.

	== Server-controlled item statistics ==		== Server-controlled item statistics ==
Line 36:		Line 36:
	Ordinary armor protection and [[Armor upgrades\|armor-upgrade-slot effects]] are implemented; see the armor guide for catalog coverage and remaining visual qualification. Special haste/orc-spore/joint effects, critical-hit multipliers, stagger damage and NPC toughness are not advertised as writable. Consult [[getItemStatDefinitions]] rather than assuming all engine fields are supported.		Ordinary armor protection and [[Armor upgrades\|armor-upgrade-slot effects]] are implemented; see the armor guide for catalog coverage and remaining visual qualification. Special haste/orc-spore/joint effects, critical-hit multipliers, stagger damage and NPC toughness are not advertised as writable. Consult [[getItemStatDefinitions]] rather than assuming all engine fields are supported.

	In-game tests have confirmed selected potion and life-jewelry scenarios, not every item, tooltip, equipped-reset case or remote/late-join lifecycle. Experimental features remain marked as such until qualification is complete. No release ~~date, final build number or protocol number for~~ 0.1.9 ~~is announced here. Use matching supported~~ client/server ~~versions when~~ the ~~update is released~~.		In-game tests have confirmed selected potion and life-jewelry scenarios, not every item, tooltip, equipped-reset case or remote/late-join lifecycle. Experimental features remain marked as such until qualification is complete. The release is BUILD264 / Protocol 42. Use matching 0.1.9 client/server packages; publication does not remove the qualification limits above.

	[[Category:Lua API]]		[[Category:Lua API]]
Line 42:		Line 42:
	<!-- armor019:start -->		<!-- armor019:start -->
	== Armor bases and upgrade pieces (from 0.1.9) ==		== Armor bases and upgrade pieces (from 0.1.9) ==
	~~Not yet publicly released; not included in public~~ 0.1.8. [[Armor catalog]] lists all 26 bases (24 existing plus Royal Guard and Judge additions); [[Armor upgrade catalog]] lists all 84 authored parts and exact family presets. [[Armor upgrades]] explains ownership, full sets, individual slots, players/NPCs, numeric protection and persistence.		Available from 0.1.9. [[Armor catalog]] lists all 26 bases (24 existing plus Royal Guard and Judge additions); [[Armor upgrade catalog]] lists all 84 authored parts and exact family presets. [[Armor upgrades]] explains ownership, full sets, individual slots, players/NPCs, numeric protection and persistence.

	Eight new server functions: [[getArmorUpgrades]], [[getArmorUpgradePresets]], [[getPlayerArmorUpgrades]], [[setPlayerArmorUpgrades]], [[setPlayerArmorPreset]], [[getNpcArmorUpgrades]], [[setNpcArmorUpgrades]], [[setNpcArmorPreset]]. Local-player and NPC checks are reported working; remote-human/late-join visual qualification remains pending~~. This is documentation, not a release announcement~~.		Eight new server functions: [[getArmorUpgrades]], [[getArmorUpgradePresets]], [[getPlayerArmorUpgrades]], [[setPlayerArmorUpgrades]], [[setPlayerArmorPreset]], [[getNpcArmorUpgrades]], [[setNpcArmorUpgrades]], [[setNpcArmorPreset]]. Local-player and NPC checks are reported working; remote-human/late-join visual qualification remains pending.
	<!-- armor019:end -->		<!-- armor019:end -->

Line 51:		Line 51:
	The existing <code>syra</code>, <code>velaya</code>, <code>seraphia</code>, <code>chani</code> and <code>natalia</code> identities receive corrected facial proportions, addressing stretched faces on female characters, including while wearing armor. The correction covers local players, remote human players and scripted human NPCs.		The existing <code>syra</code>, <code>velaya</code>, <code>seraphia</code>, <code>chani</code> and <code>natalia</code> identities receive corrected facial proportions, addressing stretched faces on female characters, including while wearing armor. The correction covers local players, remote human players and scripted human NPCs.

	A matching identity without armor displays its full authored female body/outfit; an equipped armor keeps its original shape and selected pieces with the corrected female head. Facial expression is currently neutral. Existing [[setPlayerIdentity]] and [[setNpcIdentity]] APIs are used; no separate female API is introduced. See [[Female identities]] for usage, skin/tattoo limits and synchronization expectations. This is ~~part of the upcoming~~ 0.1.9 ~~update, not a public release announcement~~.		A matching identity without armor displays its full authored female body/outfit; an equipped armor keeps its original shape and selected pieces with the corrected female head. Facial expression is currently neutral. Existing [[setPlayerIdentity]] and [[setNpcIdentity]] APIs are used; no separate female API is introduced. See [[Female identities]] for usage, skin/tattoo limits and synchronization expectations. This is included from 0.1.9.
	<!-- female019:end -->		<!-- female019:end -->

	<!-- activities019:start -->		<!-- activities019:start -->
	== Expanded activity animations and fishing ==		== Expanded activity animations and fishing ==
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released)~~.''' ~~Not included in public 0.1.8.~~ Both the server and observing clients need the matching update.		'''Available from 0.1.9.''' Both the server and observing clients need the matching update.
	'''844 additional aliases; 962 total.''' The existing 118 remain available. New entries include gathering, rice/herb processing, crafting/work variations, sitting/rest, daily activities, carrying, poses and gestures. Many entries address sections/variants of the same animation rather than separate full animations.		'''844 additional aliases; 962 total.''' The existing 118 remain available. New entries include gathering, rice/herb processing, crafting/work variations, sitting/rest, daily activities, carrying, poses and gestures. Many entries address sections/variants of the same animation rather than separate full animations.

Line 65:		Line 65:

	<!-- customkeys019:start -->		<!-- customkeys019:start -->
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~. Use matching updated server and clients.'''		'''Available from 0.1.9. Use matching updated server and clients.'''

	== Custom native keys and shared placed doors ==		== Custom native keys and shared placed doors ==
	[[Custom keys]] adds independent native key types, names/descriptions, approved model/icon reuse, multiple copies and normal authoritative drop/pickup. Server-owned door rules check canonical key quantities; wrong/local-only keys do not authorize shared operations. Includes definition/query/placement/lock APIs and lifecycle callbacks. [[World door prefab catalog]] lists the supported door aliases. Persistence/economy remain gamemode responsibilities~~. This documents upcoming functionality; it does not publish a release~~.		[[Custom keys]] adds independent native key types, names/descriptions, approved model/icon reuse, multiple copies and normal authoritative drop/pickup. Server-owned door rules check canonical key quantities; wrong/local-only keys do not authorize shared operations. Includes definition/query/placement/lock APIs and lifecycle callbacks. [[World door prefab catalog]] lists the supported door aliases. Persistence/economy remain gamemode responsibilities.
	<!-- customkeys019:end -->		<!-- customkeys019:end -->

	<!-- weather019:start -->		<!-- weather019:start -->
	== Extended weather ==		== Extended weather ==
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~. Use matching updated clients and server.'''		'''Available from 0.1.9. Use matching updated clients and server.'''

	[[Weather]] adds 38 explicit game presets alongside five legacy biome-aware modes: 43 names including snow/blizzard, fog, sky/rain and sand/dust/regional variants. [[Weather catalog]] lists every name and alias. New [[getWeatherTypes]] plus the existing set/get/revision/sync functions and [[onWeatherChange]]; shared snapshots and late join are retained. New preset rendering still requires in-game qualification; an ACK is not visual proof, and snow coverage depends on map materials.		[[Weather]] adds 38 explicit game presets alongside five legacy biome-aware modes: 43 names including snow/blizzard, fog, sky/rain and sand/dust/regional variants. [[Weather catalog]] lists every name and alias. New [[getWeatherTypes]] plus the existing set/get/revision/sync functions and [[onWeatherChange]]; shared snapshots and late join are retained. New preset rendering still requires in-game qualification; an ACK is not visual proof, and snow coverage depends on map materials.
Line 80:		Line 80:
	<!-- crafting019:start -->		<!-- crafting019:start -->
	== Native crafting-window visibility ==		== Native crafting-window visibility ==
	[[Native crafting UI]] adds the crafting key to [[setNativeHudComponentVisible]] and includes it in [[showNativeHud]]. Recipe/progress windows can be hidden while station interaction and normal exit remain. Hidden new recipe starts are guarded; running crafts are not deliberately cancelled. This is client presentation control, not a recipe API or server authorization. New getNativeUiState diagnostics and existing asynchronous result event are documented. Available from ~~upcoming~~ 0.1.9; full station qualification remains pending.		[[Native crafting UI]] adds the crafting key to [[setNativeHudComponentVisible]] and includes it in [[showNativeHud]]. Recipe/progress windows can be hidden while station interaction and normal exit remain. Hidden new recipe starts are guarded; running crafts are not deliberately cancelled. This is client presentation control, not a recipe API or server authorization. New getNativeUiState diagnostics and existing asynchronous result event are documented. Available from 0.1.9; full station qualification remains pending.
	<!-- crafting019:end -->		<!-- crafting019:end -->

Line 92:		Line 92:
	<!-- discord019:start -->		<!-- discord019:start -->
	== Optional Discord Rich Presence ==		== Optional Discord Rich Presence ==
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~. Use matching updated clients and server.'''		'''Available from 0.1.9. Use matching updated clients and server.'''

	[[Discord Rich Presence]] adds eight server Lua functions and [[onPlayerDiscordPresenceStatus]] for public server/location/job text, artwork, timers, displayed counts and two HTTPS buttons. [[Discord Presence configuration]] includes the complete optional Windows/Linux server resource and application setup. Player launcher opt-in is off by default. Resource ownership, coalescing and automatic cleanup are built in; no bot/token/account linking or automatic Join/Spectate. Real Discord visibility still requires owner-application acceptance testing~~. This documentation does not publish the release~~.		[[Discord Rich Presence]] adds eight server Lua functions and [[onPlayerDiscordPresenceStatus]] for public server/location/job text, artwork, timers, displayed counts and two HTTPS buttons. [[Discord Presence configuration]] includes the complete optional Windows/Linux server resource and application setup. Player launcher opt-in is off by default. Resource ownership, coalescing and automatic cleanup are built in; no bot/token/account linking or automatic Join/Spectate. Real Discord visibility still requires owner-application acceptance testing.
	<!-- discord019:end -->		<!-- discord019:end -->
			== Installation and compatibility ==
			* Install the matching '''0.1.9 / BUILD264 / Protocol 42''' client and dedicated server. Protocol 41 and older clients/servers are incompatible.
			* Windows and Linux each have two dedicated-server downloads: '''with TTS''' includes the CPU speech runtime/models; '''without TTS''' is smaller. TTS is optional and disabled by default in both variants. See [[TTS configuration]] before enabling it.
			* Distribution configurations contain no operator passwords or private state. Back up and preserve your own serverconf.cfg, database credentials, keys, maps and resource .storage when upgrading; merge new settings and updated bundled resources instead of overwriting your data.
			* Optional [[Discord Rich Presence]] requires server-owner configuration and a separate player opt-in. It is disabled by default.
			* Back up single-player saves before using the mod; multiplayer use may remove save files.

			== Remote head and upper-body look direction ==
			Native look direction is forwarded for remote head/neck/upper-body presentation. No new Lua command is required. Missing native look data falls back to neutral, and interaction/combat/climbing and other full-body activities take priority. This does not change gameplay aiming or damage. Full multi-player visual qualification remains pending.

StopNpcAnim

QCherry — Tue, 20 Oct 2026 13:30:06 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:30, 20 October 2026
Line 39:		Line 39:
	<!-- activities019:start -->		<!-- activities019:start -->
	== Activity cleanup from 0.1.9 ==		== Activity cleanup from 0.1.9 ==
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released)~~.''' ~~Not included in public 0.1.8.~~ Both the server and observing clients need the matching update.		'''Available from 0.1.9.''' Both the server and observing clients need the matching update.
	Use <code>stopNpcAnim(npcId)</code> for the new work/fishing/rest loops and held poses. It cleans up their animation-owned props without deleting NPC equipment or scenery. Resource ownership and route-resumption behavior remain unchanged. See [[Activity animations]].		Use <code>stopNpcAnim(npcId)</code> for the new work/fishing/rest loops and held poses. It cleans up their animation-owned props without deleting NPC equipment or scenery. Resource ownership and route-resumption behavior remain unchanged. See [[Activity animations]].
	<!-- activities019:end -->		<!-- activities019:end -->

StopAnim

QCherry — Tue, 20 Oct 2026 13:30:05 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:30, 20 October 2026
Line 40:		Line 40:
	<!-- activities019:start -->		<!-- activities019:start -->
	== Activity cleanup from 0.1.9 ==		== Activity cleanup from 0.1.9 ==
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released)~~.''' ~~Not included in public 0.1.8.~~ Both the server and observing clients need the matching update.		'''Available from 0.1.9.''' Both the server and observing clients need the matching update.
	Also ends the new [[Activity animations\|activity animations and held fishing poses]] and retires their animation-owned cosmetic props. Use <code>stopAnim(playerId)</code>; no new argument is required. It does not remove inventory rods/weapons, furniture or unrelated world objects.		Also ends the new [[Activity animations\|activity animations and held fishing poses]] and retires their animation-owned cosmetic props. Use <code>stopAnim(playerId)</code>; no new argument is required. It does not remove inventory rods/weapons, furniture or unrelated world objects.
	<!-- activities019:end -->		<!-- activities019:end -->

StartNpcAnim

QCherry — Tue, 20 Oct 2026 13:30:02 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:30, 20 October 2026
Line 46:		Line 46:
	<!-- activities019:start -->		<!-- activities019:start -->
	== Activity aliases from 0.1.9 ==		== Activity aliases from 0.1.9 ==
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released)~~.''' ~~Not included in public 0.1.8.~~ Both the server and observing clients need the matching update.		'''Available from 0.1.9.''' Both the server and observing clients need the matching update.
	Uses the same expanded catalog as [[startAnim]]: 962 aliases, including 844 additions. Example: <code>startNpcAnim(npcId, "pickrice_loop02", true, 0.15)</code>. Fishing includes the cosmetic rod. Existing resource ownership, living-NPC and holstered-weapon requirements remain. See [[Activity animations]] for examples and [[Activity animation catalog]] for modes and visual-qualification status.		Uses the same expanded catalog as [[startAnim]]: 962 aliases, including 844 additions. Example: <code>startNpcAnim(npcId, "pickrice_loop02", true, 0.15)</code>. Fishing includes the cosmetic rod. Existing resource ownership, living-NPC and holstered-weapon requirements remain. See [[Activity animations]] for examples and [[Activity animation catalog]] for modes and visual-qualification status.
	<!-- activities019:end -->		<!-- activities019:end -->

StartAnim

QCherry — Tue, 20 Oct 2026 13:30:00 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:30, 20 October 2026
Line 38:		Line 38:
	== Notes ==		== Notes ==
	* Available only in server-side resource scripts.		* Available only in server-side resource scripts.
	* [[Player animation catalog]] documents the earlier 118 aliases. From ~~upcoming~~ 0.1.9, [[Activity animation catalog]] adds 844 entries (962 total), including route/gesture variants; these additions are not all individually visually confirmed. Use [[getPlayerAnimationNames]] and [[getPlayerAnimationInfo]] to enumerate the running server catalog and recommended modes. Selected introduction/loop/exit playback retains the existing signature and default looped=false.		* [[Player animation catalog]] documents the earlier 118 aliases. From 0.1.9, [[Activity animation catalog]] adds 844 entries (962 total), including route/gesture variants; these additions are not all individually visually confirmed. Use [[getPlayerAnimationNames]] and [[getPlayerAnimationInfo]] to enumerate the running server catalog and recommended modes. Selected introduction/loop/exit playback retains the existing signature and default looped=false.
	* The optional <code>looped</code> argument explicitly controls the request. Omitting it always requests a one-shot animation; the catalog mode is an authored recommendation, not an implicit override.		* The optional <code>looped</code> argument explicitly controls the request. Omitting it always requests a one-shot animation; the catalog mode is an authored recommendation, not an implicit override.
	* Starting another scripted animation replaces the player's current scripted animation. Normal replicated gameplay actions retain their own presentation rules.		* Starting another scripted animation replaces the player's current scripted animation. Normal replicated gameplay actions retain their own presentation rules.
Line 50:		Line 50:
	<!-- activities019:start -->		<!-- activities019:start -->
	== Activity aliases from 0.1.9 ==		== Activity aliases from 0.1.9 ==
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released)~~.''' ~~Not included in public 0.1.8.~~ Both the server and observing clients need the matching update.		'''Available from 0.1.9.''' Both the server and observing clients need the matching update.
	Use the existing call, for example <code>startAnim(playerId, "fishing", true, 0.15)</code> or <code>startAnim(playerId, "pickcrouch", false, 0.15)</code>. See [[Activity animations]] and the full [[Activity animation catalog]]. Animation-owned rods/tools are cosmetic, not inventory grants; rewards and interaction validation belong to your server script. Acceptance is not a visual acknowledgement.		Use the existing call, for example <code>startAnim(playerId, "fishing", true, 0.15)</code> or <code>startAnim(playerId, "pickcrouch", false, 0.15)</code>. See [[Activity animations]] and the full [[Activity animation catalog]]. Animation-owned rods/tools are cosmetic, not inventory grants; rewards and interaction validation belong to your server script. Acceptance is not a visual acknowledgement.
	<!-- activities019:end -->		<!-- activities019:end -->

SpawnItem

QCherry — Tue, 20 Oct 2026 13:29:58 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 87:		Line 87:

	<!-- customkeys019:start -->		<!-- customkeys019:start -->
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~. Use matching updated server and clients.'''		'''Available from 0.1.9. Use matching updated server and clients.'''

	== Registered custom keys ==		== Registered custom keys ==
	This existing API also accepts the canonical item string from [[registerKeyDefinition]] in ~~upcoming~~ 0.1.9. Server registration, active definition and appropriate presentation readiness are required for mutations; use [[isPlayerKeyDefinitionReady]]. Do not pass the donor model alias as the custom item identity. Existing call shapes and limits remain; [[spawnItem]] creates one world item per call, whereas give/remove counts can manage copies. See [[Custom keys]] for safe server-side issuance, drop, pickup and persistence.		This existing API also accepts the canonical item string from [[registerKeyDefinition]] in 0.1.9. Server registration, active definition and appropriate presentation readiness are required for mutations; use [[isPlayerKeyDefinitionReady]]. Do not pass the donor model alias as the custom item identity. Existing call shapes and limits remain; [[spawnItem]] creates one world item per call, whereas give/remove counts can manage copies. See [[Custom keys]] for safe server-side issuance, drop, pickup and persistence.
	<!-- customkeys019:end -->		<!-- customkeys019:end -->

ShowNativeHud

QCherry — Tue, 20 Oct 2026 13:29:55 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 43:		Line 43:
	<!-- crafting019:start -->		<!-- crafting019:start -->
	== Crafting presentation from 0.1.9 ==		== Crafting presentation from 0.1.9 ==
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~. Use matching updated clients and server.'''		'''Available from 0.1.9. Use matching updated clients and server.'''

	[[Native crafting UI]] documents the new crafting component, recipe/progress windows, preserved station entry/exit and prevention of invisible recipe starts. It is not a setNativeMenuEnabled key or a custom recipe API. getNativeUiState gains components.crafting, craftingReady, craftingGuardReady, craftingWidgets and craftingObserved; HUD bit 64 is appended, older bits unchanged. Existing resource ownership, asynchronous result handling and restoration still apply. Full station-by-station in-game qualification remains pending.		[[Native crafting UI]] documents the new crafting component, recipe/progress windows, preserved station entry/exit and prevention of invisible recipe starts. It is not a setNativeMenuEnabled key or a custom recipe API. getNativeUiState gains components.crafting, craftingReady, craftingGuardReady, craftingWidgets and craftingObserved; HUD bit 64 is appended, older bits unchanged. Existing resource ownership, asynchronous result handling and restoration still apply. Full station-by-station in-game qualification remains pending.
	<!-- crafting019:end -->		<!-- crafting019:end -->

SetWorldDoors

QCherry — Tue, 20 Oct 2026 13:29:49 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 1:		Line 1:
	= setWorldDoors =		= setWorldDoors =
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~. Use matching updated server and clients.'''		'''Available from 0.1.9. Use matching updated server and clients.'''

	Server Lua. Part of [[Custom keys\|custom keys and shared placed doors]].		Server Lua. Part of [[Custom keys\|custom keys and shared placed doors]].

SetWorldDoorLocked

QCherry — Tue, 20 Oct 2026 13:29:47 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 1:		Line 1:
	= setWorldDoorLocked =		= setWorldDoorLocked =
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~. Use matching updated server and clients.'''		'''Available from 0.1.9. Use matching updated server and clients.'''

	Server Lua. Part of [[Custom keys\|custom keys and shared placed doors]].		Server Lua. Part of [[Custom keys\|custom keys and shared placed doors]].

SetWorldDoorKey

QCherry — Tue, 20 Oct 2026 13:29:46 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 1:		Line 1:
	= setWorldDoorKey =		= setWorldDoorKey =
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~. Use matching updated server and clients.'''		'''Available from 0.1.9. Use matching updated server and clients.'''

	Server Lua. Part of [[Custom keys\|custom keys and shared placed doors]].		Server Lua. Part of [[Custom keys\|custom keys and shared placed doors]].

SetWeather

QCherry — Tue, 20 Oct 2026 13:29:44 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 49:		Line 49:
	<!-- weather019:start -->		<!-- weather019:start -->
	== Extended weather from 0.1.9 ==		== Extended weather from 0.1.9 ==
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~. Use matching updated clients and server.'''		'''Available from 0.1.9. Use matching updated clients and server.'''

	This existing API retains its call shape; the catalog is extended, not restricted to five names. See [[Weather]] and [[Weather catalog]]. Server target/revision and client acknowledgement are not proof of the final rendered image. The new presets still require in-game visual qualification; use compatible clients and test late join, indoor areas and returning to ordinary weather.		This existing API retains its call shape; the catalog is extended, not restricted to five names. See [[Weather]] and [[Weather catalog]]. Server target/revision and client acknowledgement are not proof of the final rendered image. The new presets still require in-game visual qualification; use compatible clients and test late join, indoor areas and returning to ordinary weather.
	<!-- weather019:end -->		<!-- weather019:end -->

SetPlayerMana

QCherry — Tue, 20 Oct 2026 13:29:43 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 36:		Line 36:

	<!-- upcoming019:start -->		<!-- upcoming019:start -->
	== Mana-state correction (~~planned for~~ 0.1.9) ==		== Mana-state correction (from 0.1.9) ==
	The ~~upcoming~~ client clears a stale out-of-mana condition after a successful, verified positive mana assignment. This addresses casting remaining blocked despite the updated mana display, without requiring a game restart. Zero/insufficient mana still blocks ordinary paid casts; rune ownership, equipment, circle and other eligibility checks remain. This improves the existing mana setter; it is not a new Lua function. Separate custom rune manaCost profiles are described in [[Item type stats]] and remain under in-game qualification~~. Public 0.1.8 does not include this correction~~.		The 0.1.9 client clears a stale out-of-mana condition after a successful, verified positive mana assignment. This addresses casting remaining blocked despite the updated mana display, without requiring a game restart. Zero/insufficient mana still blocks ordinary paid casts; rune ownership, equipment, circle and other eligibility checks remain. This improves the existing mana setter; it is not a new Lua function. Separate custom rune manaCost profiles are described in [[Item type stats]] and remain under in-game qualification.
	<!-- upcoming019:end -->		<!-- upcoming019:end -->

SetPlayerIdentity

QCherry — Tue, 20 Oct 2026 13:29:41 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 5:		Line 5:
	</div>		</div>

	Selects a named identity while preserving equipped armor and independent cosmetic overrides. See [[Female identities]] for the expanded female body/outfit presentation from ~~upcoming~~ 0.1.9.		Selects a named identity while preserving equipped armor and independent cosmetic overrides. See [[Female identities]] for the expanded female body/outfit presentation from 0.1.9.

	== Syntax ==		== Syntax ==
Line 35:		Line 35:
	* Available only in server-side resource scripts.		* Available only in server-side resource scripts.
	* This existing API has improved behavior in 0.1.3; it was not introduced in that release. Use a key from <code>getPlayerIdentityNames</code>, including <code>default</code> to select the default identity.		* This existing API has improved behavior in 0.1.3; it was not introduced in that release. Use a key from <code>getPlayerIdentityNames</code>, including <code>default</code> to select the default identity.
	* In ~~public~~ 0.1.8, the client applies a head-only identity layer with supported face/hair/beard geometry. From ~~upcoming~~ 0.1.9, the five [[Female identities\|supported female identities]] also display their full authored outfit when no armor is equipped and body/head selections match. With armor equipped, the corrected female head is shown with the native armor. This is not a general body-shape or arbitrary model replacement API.		* In 0.1.8, the client applies a head-only identity layer with supported face/hair/beard geometry. From 0.1.9, the five [[Female identities\|supported female identities]] also display their full authored outfit when no armor is equipped and body/head selections match. With armor equipped, the corrected female head is shown with the native armor. This is not a general body-shape or arbitrary model replacement API.
	* The identity layers are committed together in server state. Native asset loading and visual reconstruction are asynchronous, so a successful call does not promise an immediately complete image on every client.		* The identity layers are committed together in server state. Native asset loading and visual reconstruction are asynchronous, so a successful call does not promise an immediately complete image on every client.
	* Equipped armor remains controlled independently by <code>setPlayerArmor</code>. This call does not equip or remove items, change HP/progression, or reset <code>setPlayerSkinColor</code>/<code>setPlayerTattoo</code> overrides.		* Equipped armor remains controlled independently by <code>setPlayerArmor</code>. This call does not equip or remove items, change HP/progression, or reset <code>setPlayerSkinColor</code>/<code>setPlayerTattoo</code> overrides.
Line 50:		Line 50:
	<!-- female019:start -->		<!-- female019:start -->
	== Female presentation improved from 0.1.9 ==		== Female presentation improved from 0.1.9 ==
	'''Improved from 0.1.9 ~~(upcoming; not yet publicly released)~~.''' ~~This improvement is not included in public 0.1.8.~~		'''Improved from 0.1.9.'''
	<code>setPlayerIdentity(playerId, "syra")</code> selects the matched identity; the same applies to <code>velaya</code>, <code>seraphia</code>, <code>chani</code> and <code>natalia</code>. Identity selection remains an existing API. See [[Female identities]] for full-outfit/armor behavior, neutral facial expression and supported customization. The call does not remove armor, change protection or clear tint/tattoos.		<code>setPlayerIdentity(playerId, "syra")</code> selects the matched identity; the same applies to <code>velaya</code>, <code>seraphia</code>, <code>chani</code> and <code>natalia</code>. Identity selection remains an existing API. See [[Female identities]] for full-outfit/armor behavior, neutral facial expression and supported customization. The call does not remove armor, change protection or clear tint/tattoos.
	<!-- female019:end -->		<!-- female019:end -->

SetPlayerDiscordPresence

QCherry — Tue, 20 Oct 2026 13:29:40 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 1:		Line 1:
	= setPlayerDiscordPresence =		= setPlayerDiscordPresence =
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~. Use matching updated clients and server.'''		'''Available from 0.1.9. Use matching updated clients and server.'''

	'''Server-side only.''' Part of [[Discord Rich Presence]]. See [[Discord Presence configuration]] for the optional server-owner resource.		'''Server-side only.''' Part of [[Discord Rich Presence]]. See [[Discord Presence configuration]] for the optional server-owner resource.

SetPlayerArmorUpgrades

QCherry — Tue, 20 Oct 2026 13:29:38 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 2:		Line 2:
	<div style="background:#fff5f5; border:1px solid #d13b3b; border-left:5px solid #d13b3b; color:#111111; padding:0.85rem 1rem; margin:0.75rem 0 1rem;">		<div style="background:#fff5f5; border:1px solid #d13b3b; border-left:5px solid #d13b3b; color:#111111; padding:0.85rem 1rem; margin:0.75rem 0 1rem;">
	<div style="color:#111111; font-weight:bold; letter-spacing:0.04em;">AVAILABLE FROM UPDATE 0.1.9</div>		<div style="color:#111111; font-weight:bold; letter-spacing:0.04em;">AVAILABLE FROM UPDATE 0.1.9</div>
	<div style="color:#111111; margin-top:0.25rem;">Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~.</div>		<div style="color:#111111; margin-top:0.25rem;">Available from 0.1.9.</div>
	</div>		</div>

Line 34:		Line 34:

	== Notes ==		== Notes ==
	* Server-side only; available from 0.1.9~~, not yet publicly released. Not included in public 0.1.8~~.		* Server-side only; available from 0.1.9.
	* See [[Armor upgrades]], [[Armor catalog]] and [[Armor upgrade catalog]].		* See [[Armor upgrades]], [[Armor catalog]] and [[Armor upgrade catalog]].
	* The player must own the equipped base and every selected part, and satisfy the server equipment requirements. No items or attributes are granted.		* The player must own the equipped base and every selected part, and satisfy the server equipment requirements. No items or attributes are granted.

SetPlayerArmorPreset

QCherry — Tue, 20 Oct 2026 13:29:37 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 2:		Line 2:
	<div style="background:#fff5f5; border:1px solid #d13b3b; border-left:5px solid #d13b3b; color:#111111; padding:0.85rem 1rem; margin:0.75rem 0 1rem;">		<div style="background:#fff5f5; border:1px solid #d13b3b; border-left:5px solid #d13b3b; color:#111111; padding:0.85rem 1rem; margin:0.75rem 0 1rem;">
	<div style="color:#111111; font-weight:bold; letter-spacing:0.04em;">AVAILABLE FROM UPDATE 0.1.9</div>		<div style="color:#111111; font-weight:bold; letter-spacing:0.04em;">AVAILABLE FROM UPDATE 0.1.9</div>
	<div style="color:#111111; margin-top:0.25rem;">Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~.</div>		<div style="color:#111111; margin-top:0.25rem;">Available from 0.1.9.</div>
	</div>		</div>

Line 33:		Line 33:

	== Notes ==		== Notes ==
	* Server-side only; available from 0.1.9~~, not yet publicly released. Not included in public 0.1.8~~.		* Server-side only; available from 0.1.9.
	* See [[Armor upgrades]], [[Armor catalog]] and [[Armor upgrade catalog]].		* See [[Armor upgrades]], [[Armor catalog]] and [[Armor upgrade catalog]].
	* The player must own the equipped base and every selected part, and satisfy the server equipment requirements. No items or attributes are granted.		* The player must own the equipped base and every selected part, and satisfy the server equipment requirements. No items or attributes are granted.

SetPlayerArmor

QCherry — Tue, 20 Oct 2026 13:29:35 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 48:		Line 48:
	<!-- armor019:start -->		<!-- armor019:start -->
	== Armor parts (from 0.1.9) ==		== Armor parts (from 0.1.9) ==
	~~Upcoming; not included in public~~ 0.1.8. [[Armor catalog]] lists the 26 bases; [[Armor upgrade catalog]] lists all 84 pieces. This existing function/guide is not newly introduced in 0.1.9. The new [[Armor upgrades\|upgrade system]] adds per-character top/mid/bottom selections, full presets and separate player/NPC setters. A different base clears the old parts; choosing the same base keeps compatible selections. Identity, skin tint and tattoos remain separate. See the guide for requirements, safe replacement and synchronization validation.		Available from 0.1.9. [[Armor catalog]] lists the 26 bases; [[Armor upgrade catalog]] lists all 84 pieces. This existing function/guide is not newly introduced in 0.1.9. The new [[Armor upgrades\|upgrade system]] adds per-character top/mid/bottom selections, full presets and separate player/NPC setters. A different base clears the old parts; choosing the same base keeps compatible selections. Identity, skin tint and tattoos remain separate. See the guide for requirements, safe replacement and synchronization validation.
	<!-- armor019:end -->		<!-- armor019:end -->

SetNpcMaxMana

QCherry — Tue, 20 Oct 2026 13:29:30 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 40:		Line 40:

	<!-- upcoming019:start -->		<!-- upcoming019:start -->
	== Item-type armor bonuses (~~planned for~~ 0.1.9) ==		== Item-type armor bonuses (from 0.1.9) ==
	[[Item type stats]] adds explicit armor bonusHealth/bonusMana/bonusStrength/bonusDexterity contributions for equipped scripted NPCs, plus the armor protection profile. Unconfigured native bonuses do not silently change existing NPC balance. Base stats and bonuses are separate; raising maxima does not heal/refill and lowering maxima clamps current values without reviving dead NPCs.		[[Item type stats]] adds explicit armor bonusHealth/bonusMana/bonusStrength/bonusDexterity contributions for equipped scripted NPCs, plus the armor protection profile. Unconfigured native bonuses do not silently change existing NPC balance. Base stats and bonuses are separate; raising maxima does not heal/refill and lowering maxima clamps current values without reviving dead NPCs.

	setNpcMaxHealth/setNpcMaxMana set BASE maxima; getNpcMaxHealth/getNpcMaxMana return EFFECTIVE maxima. setNpcCombatConfig/getNpcCombatConfig dexterity is BASE dexterity. getNpcData adds baseMaxHealth, baseMaxMana, baseDexterity, mana, maxMana, dexterity, armorHealthBonus, armorManaBonus, armorStrengthBonus and armorDexterityBonus.		setNpcMaxHealth/setNpcMaxMana set BASE maxima; getNpcMaxHealth/getNpcMaxMana return EFFECTIVE maxima. setNpcCombatConfig/getNpcCombatConfig dexterity is BASE dexterity. getNpcData adds baseMaxHealth, baseMaxMana, baseDexterity, mana, maxMana, dexterity, armorHealthBonus, armorManaBonus, armorStrengthBonus and armorDexterityBonus.

	NPC melee includes explicit armor strength and ranged combat uses effective dexterity. Numeric refresh preserves accepted attack/projectile snapshots; it does not reload ammo or restart prepared casts. NPC toughness and NPC jewelry are not implemented by this addition. These are extensions to existing APIs, not new names or a replacement for their earlier contracts~~. Not included in public 0.1.8~~.		NPC melee includes explicit armor strength and ranged combat uses effective dexterity. Numeric refresh preserves accepted attack/projectile snapshots; it does not reload ammo or restart prepared casts. NPC toughness and NPC jewelry are not implemented by this addition. These are extensions to existing APIs, not new names or a replacement for their earlier contracts.
	<!-- upcoming019:end -->		<!-- upcoming019:end -->

SetNpcMaxHealth

QCherry — Tue, 20 Oct 2026 13:29:28 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 40:		Line 40:

	<!-- upcoming019:start -->		<!-- upcoming019:start -->
	== Item-type armor bonuses (~~planned for~~ 0.1.9) ==		== Item-type armor bonuses (from 0.1.9) ==
	[[Item type stats]] adds explicit armor bonusHealth/bonusMana/bonusStrength/bonusDexterity contributions for equipped scripted NPCs, plus the armor protection profile. Unconfigured native bonuses do not silently change existing NPC balance. Base stats and bonuses are separate; raising maxima does not heal/refill and lowering maxima clamps current values without reviving dead NPCs.		[[Item type stats]] adds explicit armor bonusHealth/bonusMana/bonusStrength/bonusDexterity contributions for equipped scripted NPCs, plus the armor protection profile. Unconfigured native bonuses do not silently change existing NPC balance. Base stats and bonuses are separate; raising maxima does not heal/refill and lowering maxima clamps current values without reviving dead NPCs.

	setNpcMaxHealth/setNpcMaxMana set BASE maxima; getNpcMaxHealth/getNpcMaxMana return EFFECTIVE maxima. setNpcCombatConfig/getNpcCombatConfig dexterity is BASE dexterity. getNpcData adds baseMaxHealth, baseMaxMana, baseDexterity, mana, maxMana, dexterity, armorHealthBonus, armorManaBonus, armorStrengthBonus and armorDexterityBonus.		setNpcMaxHealth/setNpcMaxMana set BASE maxima; getNpcMaxHealth/getNpcMaxMana return EFFECTIVE maxima. setNpcCombatConfig/getNpcCombatConfig dexterity is BASE dexterity. getNpcData adds baseMaxHealth, baseMaxMana, baseDexterity, mana, maxMana, dexterity, armorHealthBonus, armorManaBonus, armorStrengthBonus and armorDexterityBonus.

	NPC melee includes explicit armor strength and ranged combat uses effective dexterity. Numeric refresh preserves accepted attack/projectile snapshots; it does not reload ammo or restart prepared casts. NPC toughness and NPC jewelry are not implemented by this addition. These are extensions to existing APIs, not new names or a replacement for their earlier contracts~~. Not included in public 0.1.8~~.		NPC melee includes explicit armor strength and ranged combat uses effective dexterity. Numeric refresh preserves accepted attack/projectile snapshots; it does not reload ammo or restart prepared casts. NPC toughness and NPC jewelry are not implemented by this addition. These are extensions to existing APIs, not new names or a replacement for their earlier contracts.
	<!-- upcoming019:end -->		<!-- upcoming019:end -->

SetNpcIdentity

QCherry — Tue, 20 Oct 2026 13:29:26 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 35:		Line 35:
	* Does not change authoritative HP, weapons, armor, routes or combat configuration. No automatic persistent database storage.		* Does not change authoritative HP, weapons, armor, routes or combat configuration. No automatic persistent database storage.
	* Upper-initial alias SetNpcIdentity is also supported.		* Upper-initial alias SetNpcIdentity is also supported.
	* Use default to explicitly restore the Nameless Hero identity. Preserves armor, skin-color and tattoo overrides. In ~~public~~ 0.1.8 it does not replace the whole NPC outfit. From ~~upcoming~~ 0.1.9, the five supported female identities can show their full authored outfit without armor; see [[Female identities]]. Existing setNpcSkin remains a separate legacy preset.		* Use default to explicitly restore the Nameless Hero identity. Preserves armor, skin-color and tattoo overrides. In 0.1.8 it does not replace the whole NPC outfit. From 0.1.9, the five supported female identities can show their full authored outfit without armor; see [[Female identities]]. Existing setNpcSkin remains a separate legacy preset.

	[[Category:Lua Functions]]		[[Category:Lua Functions]]
Line 44:		Line 44:
	<!-- female019:start -->		<!-- female019:start -->
	== Female presentation improved from 0.1.9 ==		== Female presentation improved from 0.1.9 ==
	'''Improved from 0.1.9 ~~(upcoming; not yet publicly released)~~.''' ~~This improvement is not included in public 0.1.8.~~		'''Improved from 0.1.9.'''
	<code>setNpcIdentity(npcId, "syra")</code> selects a matching female identity for a resource-owned human NPC. The same correction covers <code>velaya</code>, <code>seraphia</code>, <code>chani</code> and <code>natalia</code>. Without armor the matching identity shows its authored female outfit; with armor it retains the native armor and corrected head. Face expression remains neutral. See [[Female identities]] for examples and material limits. This improves the existing API, available since 0.1.5; it does not introduce a new NPC setter.		<code>setNpcIdentity(npcId, "syra")</code> selects a matching female identity for a resource-owned human NPC. The same correction covers <code>velaya</code>, <code>seraphia</code>, <code>chani</code> and <code>natalia</code>. Without armor the matching identity shows its authored female outfit; with armor it retains the native armor and corrected head. Face expression remains neutral. See [[Female identities]] for examples and material limits. This improves the existing API, available since 0.1.5; it does not introduce a new NPC setter.
	<!-- female019:end -->		<!-- female019:end -->

SetNpcCombatConfig

QCherry — Tue, 20 Oct 2026 13:29:24 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 61:		Line 61:

	<!-- upcoming019:start -->		<!-- upcoming019:start -->
	== Item-type armor bonuses (~~planned for~~ 0.1.9) ==		== Item-type armor bonuses (from 0.1.9) ==
	[[Item type stats]] adds explicit armor bonusHealth/bonusMana/bonusStrength/bonusDexterity contributions for equipped scripted NPCs, plus the armor protection profile. Unconfigured native bonuses do not silently change existing NPC balance. Base stats and bonuses are separate; raising maxima does not heal/refill and lowering maxima clamps current values without reviving dead NPCs.		[[Item type stats]] adds explicit armor bonusHealth/bonusMana/bonusStrength/bonusDexterity contributions for equipped scripted NPCs, plus the armor protection profile. Unconfigured native bonuses do not silently change existing NPC balance. Base stats and bonuses are separate; raising maxima does not heal/refill and lowering maxima clamps current values without reviving dead NPCs.

	setNpcMaxHealth/setNpcMaxMana set BASE maxima; getNpcMaxHealth/getNpcMaxMana return EFFECTIVE maxima. setNpcCombatConfig/getNpcCombatConfig dexterity is BASE dexterity. getNpcData adds baseMaxHealth, baseMaxMana, baseDexterity, mana, maxMana, dexterity, armorHealthBonus, armorManaBonus, armorStrengthBonus and armorDexterityBonus.		setNpcMaxHealth/setNpcMaxMana set BASE maxima; getNpcMaxHealth/getNpcMaxMana return EFFECTIVE maxima. setNpcCombatConfig/getNpcCombatConfig dexterity is BASE dexterity. getNpcData adds baseMaxHealth, baseMaxMana, baseDexterity, mana, maxMana, dexterity, armorHealthBonus, armorManaBonus, armorStrengthBonus and armorDexterityBonus.

	NPC melee includes explicit armor strength and ranged combat uses effective dexterity. Numeric refresh preserves accepted attack/projectile snapshots; it does not reload ammo or restart prepared casts. NPC toughness and NPC jewelry are not implemented by this addition. These are extensions to existing APIs, not new names or a replacement for their earlier contracts~~. Not included in public 0.1.8~~.		NPC melee includes explicit armor strength and ranged combat uses effective dexterity. Numeric refresh preserves accepted attack/projectile snapshots; it does not reload ammo or restart prepared casts. NPC toughness and NPC jewelry are not implemented by this addition. These are extensions to existing APIs, not new names or a replacement for their earlier contracts.
	<!-- upcoming019:end -->		<!-- upcoming019:end -->

SetNpcArmorUpgrades

QCherry — Tue, 20 Oct 2026 13:29:22 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 2:		Line 2:
	<div style="background:#fff5f5; border:1px solid #d13b3b; border-left:5px solid #d13b3b; color:#111111; padding:0.85rem 1rem; margin:0.75rem 0 1rem;">		<div style="background:#fff5f5; border:1px solid #d13b3b; border-left:5px solid #d13b3b; color:#111111; padding:0.85rem 1rem; margin:0.75rem 0 1rem;">
	<div style="color:#111111; font-weight:bold; letter-spacing:0.04em;">AVAILABLE FROM UPDATE 0.1.9</div>		<div style="color:#111111; font-weight:bold; letter-spacing:0.04em;">AVAILABLE FROM UPDATE 0.1.9</div>
	<div style="color:#111111; margin-top:0.25rem;">Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~.</div>		<div style="color:#111111; margin-top:0.25rem;">Available from 0.1.9.</div>
	</div>		</div>

Line 34:		Line 34:

	== Notes ==		== Notes ==
	* Server-side only; available from 0.1.9~~, not yet publicly released. Not included in public 0.1.8~~.		* Server-side only; available from 0.1.9.
	* See [[Armor upgrades]], [[Armor catalog]] and [[Armor upgrade catalog]].		* See [[Armor upgrades]], [[Armor catalog]] and [[Armor upgrade catalog]].
	* Only the resource owning the NPC may change its parts. No player-inventory or player-requirement check is applied to NPCs.		* Only the resource owning the NPC may change its parts. No player-inventory or player-requirement check is applied to NPCs.

SetNpcArmorPreset

QCherry — Tue, 20 Oct 2026 13:29:21 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 2:		Line 2:
	<div style="background:#fff5f5; border:1px solid #d13b3b; border-left:5px solid #d13b3b; color:#111111; padding:0.85rem 1rem; margin:0.75rem 0 1rem;">		<div style="background:#fff5f5; border:1px solid #d13b3b; border-left:5px solid #d13b3b; color:#111111; padding:0.85rem 1rem; margin:0.75rem 0 1rem;">
	<div style="color:#111111; font-weight:bold; letter-spacing:0.04em;">AVAILABLE FROM UPDATE 0.1.9</div>		<div style="color:#111111; font-weight:bold; letter-spacing:0.04em;">AVAILABLE FROM UPDATE 0.1.9</div>
	<div style="color:#111111; margin-top:0.25rem;">Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~.</div>		<div style="color:#111111; margin-top:0.25rem;">Available from 0.1.9.</div>
	</div>		</div>

Line 34:		Line 34:

	== Notes ==		== Notes ==
	* Server-side only; available from 0.1.9~~, not yet publicly released. Not included in public 0.1.8~~.		* Server-side only; available from 0.1.9.
	* See [[Armor upgrades]], [[Armor catalog]] and [[Armor upgrade catalog]].		* See [[Armor upgrades]], [[Armor catalog]] and [[Armor upgrade catalog]].
	* Only the resource owning the NPC may change its parts. No player-inventory or player-requirement check is applied to NPCs.		* Only the resource owning the NPC may change its parts. No player-inventory or player-requirement check is applied to NPCs.

SetNpcArmor

QCherry — Tue, 20 Oct 2026 13:29:19 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 45:		Line 45:
	<!-- armor019:start -->		<!-- armor019:start -->
	== Armor parts (from 0.1.9) ==		== Armor parts (from 0.1.9) ==
	~~Upcoming; not included in public~~ 0.1.8. [[Armor catalog]] lists the 26 bases; [[Armor upgrade catalog]] lists all 84 pieces. This existing function/guide is not newly introduced in 0.1.9. The new [[Armor upgrades\|upgrade system]] adds per-character top/mid/bottom selections, full presets and separate player/NPC setters. A different base clears the old parts; choosing the same base keeps compatible selections. Identity, skin tint and tattoos remain separate. See the guide for requirements, safe replacement and synchronization validation.		Available from 0.1.9. [[Armor catalog]] lists the 26 bases; [[Armor upgrade catalog]] lists all 84 pieces. This existing function/guide is not newly introduced in 0.1.9. The new [[Armor upgrades\|upgrade system]] adds per-character top/mid/bottom selections, full presets and separate player/NPC setters. A different base clears the old parts; choosing the same base keeps compatible selections. Identity, skin tint and tattoos remain separate. See the guide for requirements, safe replacement and synchronization validation.
	<!-- armor019:end -->		<!-- armor019:end -->

SetNativeHudComponentVisible

QCherry — Tue, 20 Oct 2026 13:29:17 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 44:		Line 44:
	<!-- crafting019:start -->		<!-- crafting019:start -->
	== Crafting presentation from 0.1.9 ==		== Crafting presentation from 0.1.9 ==
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~. Use matching updated clients and server.'''		'''Available from 0.1.9. Use matching updated clients and server.'''

	[[Native crafting UI]] documents the new crafting component, recipe/progress windows, preserved station entry/exit and prevention of invisible recipe starts. It is not a setNativeMenuEnabled key or a custom recipe API. getNativeUiState gains components.crafting, craftingReady, craftingGuardReady, craftingWidgets and craftingObserved; HUD bit 64 is appended, older bits unchanged. Existing resource ownership, asynchronous result handling and restoration still apply. Full station-by-station in-game qualification remains pending.		[[Native crafting UI]] documents the new crafting component, recipe/progress windows, preserved station entry/exit and prevention of invisible recipe starts. It is not a setNativeMenuEnabled key or a custom recipe API. getNativeUiState gains components.crafting, craftingReady, craftingGuardReady, craftingWidgets and craftingObserved; HUD bit 64 is appended, older bits unchanged. Existing resource ownership, asynchronous result handling and restoration still apply. Full station-by-station in-game qualification remains pending.
	<!-- crafting019:end -->		<!-- crafting019:end -->

SetItemStatsBatch

QCherry — Tue, 20 Oct 2026 13:29:14 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 2:		Line 2:
	<div style="background:#fff5f5; border:1px solid #d13b3b; border-left:5px solid #d13b3b; color:#111111; padding:0.85rem 1rem; margin:0.75rem 0 1rem;">		<div style="background:#fff5f5; border:1px solid #d13b3b; border-left:5px solid #d13b3b; color:#111111; padding:0.85rem 1rem; margin:0.75rem 0 1rem;">
	<div style="color:#111111; font-weight:bold; letter-spacing:0.04em;">AVAILABLE FROM UPDATE 0.1.9</div>		<div style="color:#111111; font-weight:bold; letter-spacing:0.04em;">AVAILABLE FROM UPDATE 0.1.9</div>
	<div style="color:#111111; margin-top:0.25rem;">~~Planned for~~ 0.1.9~~; not yet publicly released. Not included in public 0.1.8~~. See the scope and validation notes below.</div>		<div style="color:#111111; margin-top:0.25rem;">Available from 0.1.9. See the scope and validation notes below.</div>
	</div>		</div>

Line 33:		Line 33:

	== Notes ==		== Notes ==
	* ~~Planned for~~ G1R:MP 0.1.9~~; not yet publicly released and not included in public 0.1.8~~. This documents the implemented ~~development~~ API~~, not a release announcement~~. See [[Item type stats]] for scope and remaining in-game validation.		* Available from G1R:MP 0.1.9. This documents the implemented API and its current limits. See [[Item type stats]] for scope and remaining in-game validation.
	* Server-side only. Profiles affect every copy of the same type on this server, across dimensions; not individual item instances.		* Server-side only. Profiles affect every copy of the same type on this server, across dimensions; not individual item instances.
	* Use matching supported client and server builds. Server acceptance and a client application report do not prove the native gameplay effect.		* Use matching supported client and server builds. Server acceptance and a client application report do not prove the native gameplay effect.

SetItemStats

QCherry — Tue, 20 Oct 2026 13:29:12 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 2:		Line 2:
	<div style="background:#fff5f5; border:1px solid #d13b3b; border-left:5px solid #d13b3b; color:#111111; padding:0.85rem 1rem; margin:0.75rem 0 1rem;">		<div style="background:#fff5f5; border:1px solid #d13b3b; border-left:5px solid #d13b3b; color:#111111; padding:0.85rem 1rem; margin:0.75rem 0 1rem;">
	<div style="color:#111111; font-weight:bold; letter-spacing:0.04em;">AVAILABLE FROM UPDATE 0.1.9</div>		<div style="color:#111111; font-weight:bold; letter-spacing:0.04em;">AVAILABLE FROM UPDATE 0.1.9</div>
	<div style="color:#111111; margin-top:0.25rem;">~~Planned for~~ 0.1.9~~; not yet publicly released. Not included in public 0.1.8~~. See the scope and validation notes below.</div>		<div style="color:#111111; margin-top:0.25rem;">Available from 0.1.9. See the scope and validation notes below.</div>
	</div>		</div>

Line 34:		Line 34:

	== Notes ==		== Notes ==
	* ~~Planned for~~ G1R:MP 0.1.9~~; not yet publicly released and not included in public 0.1.8~~. This documents the implemented ~~development~~ API~~, not a release announcement~~. See [[Item type stats]] for scope and remaining in-game validation.		* Available from G1R:MP 0.1.9. This documents the implemented API and its current limits. See [[Item type stats]] for scope and remaining in-game validation.
	* Server-side only. Profiles affect every copy of the same type on this server, across dimensions; not individual item instances.		* Server-side only. Profiles affect every copy of the same type on this server, across dimensions; not individual item instances.
	* Use matching supported client and server builds. Server acceptance and a client application report do not prove the native gameplay effect.		* Use matching supported client and server builds. Server acceptance and a client application report do not prove the native gameplay effect.

SetDiscordApplicationId

QCherry — Tue, 20 Oct 2026 13:29:11 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 1:		Line 1:
	= setDiscordApplicationId =		= setDiscordApplicationId =
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~. Use matching updated clients and server.'''		'''Available from 0.1.9. Use matching updated clients and server.'''

	'''Server-side only.''' Part of [[Discord Rich Presence]]. See [[Discord Presence configuration]] for the optional server-owner resource.		'''Server-side only.''' Part of [[Discord Rich Presence]]. See [[Discord Presence configuration]] for the optional server-owner resource.

Server configuration limits

QCherry — Tue, 20 Oct 2026 13:29:10 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 195:		Line 195:
	<!-- weather019:start -->		<!-- weather019:start -->
	== Extended weather configuration (from 0.1.9) ==		== Extended weather configuration (from 0.1.9) ==
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~. Use matching updated clients and server.'''		'''Available from 0.1.9. Use matching updated clients and server.'''

	The world weather setting accepts the canonical names and aliases in [[Weather catalog]]. Weather transition remains 0..300000 milliseconds. Existing modes remain biome-dependent; explicit presets add snow, fog, dust and regional variations. See [[Weather]] for examples. This does not change current public-release configuration support.		The world weather setting accepts the canonical names and aliases in [[Weather catalog]]. Weather transition remains 0..300000 milliseconds. Existing modes remain biome-dependent; explicit presets add snow, fog, dust and regional variations. See [[Weather]] for examples. This does not change current public-release configuration support.
Line 202:		Line 202:
	<!-- discord019:start -->		<!-- discord019:start -->
	== Optional Discord presence (from 0.1.9) ==		== Optional Discord presence (from 0.1.9) ==
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~. Use matching updated clients and server.'''		'''Available from 0.1.9. Use matching updated clients and server.'''

	[[Discord Presence configuration]] provides the complete server-only resource. Configure its public Application ID and presentation fields in config.lua, then append its name to your existing resources autostart list. No new [discord] INI section, bot token, Client Secret, Discord installation, Python or SDK is needed on either Windows or Linux dedicated servers. Players opt in separately in launcher Settings and rejoin. Keep existing gamemode/server settings; do not enable development QA commands publicly.		[[Discord Presence configuration]] provides the complete server-only resource. Configure its public Application ID and presentation fields in config.lua, then append its name to your existing resources autostart list. No new [discord] INI section, bot token, Client Secret, Discord installation, Python or SDK is needed on either Windows or Linux dedicated servers. Players opt in separately in launcher Settings and rejoin. Keep existing gamemode/server settings; do not enable development QA commands publicly.
	<!-- discord019:end -->		<!-- discord019:end -->

Scripting limits

QCherry — Tue, 20 Oct 2026 13:29:08 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

ResetItemStats

QCherry — Tue, 20 Oct 2026 13:29:07 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 2:		Line 2:
	<div style="background:#fff5f5; border:1px solid #d13b3b; border-left:5px solid #d13b3b; color:#111111; padding:0.85rem 1rem; margin:0.75rem 0 1rem;">		<div style="background:#fff5f5; border:1px solid #d13b3b; border-left:5px solid #d13b3b; color:#111111; padding:0.85rem 1rem; margin:0.75rem 0 1rem;">
	<div style="color:#111111; font-weight:bold; letter-spacing:0.04em;">AVAILABLE FROM UPDATE 0.1.9</div>		<div style="color:#111111; font-weight:bold; letter-spacing:0.04em;">AVAILABLE FROM UPDATE 0.1.9</div>
	<div style="color:#111111; margin-top:0.25rem;">~~Planned for~~ 0.1.9~~; not yet publicly released. Not included in public 0.1.8~~. See the scope and validation notes below.</div>		<div style="color:#111111; margin-top:0.25rem;">Available from 0.1.9. See the scope and validation notes below.</div>
	</div>		</div>

Line 33:		Line 33:

	== Notes ==		== Notes ==
	* ~~Planned for~~ G1R:MP 0.1.9~~; not yet publicly released and not included in public 0.1.8~~. This documents the implemented ~~development~~ API~~, not a release announcement~~. See [[Item type stats]] for scope and remaining in-game validation.		* Available from G1R:MP 0.1.9. This documents the implemented API and its current limits. See [[Item type stats]] for scope and remaining in-game validation.
	* Server-side only. Profiles affect every copy of the same type on this server, across dimensions; not individual item instances.		* Server-side only. Profiles affect every copy of the same type on this server, across dimensions; not individual item instances.
	* Use matching supported client and server builds. Server acceptance and a client application report do not prove the native gameplay effect.		* Use matching supported client and server builds. Server acceptance and a client application report do not prove the native gameplay effect.

ReplaceItemStatsProfile

QCherry — Tue, 20 Oct 2026 13:29:05 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 2:		Line 2:
	<div style="background:#fff5f5; border:1px solid #d13b3b; border-left:5px solid #d13b3b; color:#111111; padding:0.85rem 1rem; margin:0.75rem 0 1rem;">		<div style="background:#fff5f5; border:1px solid #d13b3b; border-left:5px solid #d13b3b; color:#111111; padding:0.85rem 1rem; margin:0.75rem 0 1rem;">
	<div style="color:#111111; font-weight:bold; letter-spacing:0.04em;">AVAILABLE FROM UPDATE 0.1.9</div>		<div style="color:#111111; font-weight:bold; letter-spacing:0.04em;">AVAILABLE FROM UPDATE 0.1.9</div>
	<div style="color:#111111; margin-top:0.25rem;">~~Planned for~~ 0.1.9~~; not yet publicly released. Not included in public 0.1.8~~. See the scope and validation notes below.</div>		<div style="color:#111111; margin-top:0.25rem;">Available from 0.1.9. See the scope and validation notes below.</div>
	</div>		</div>

Line 34:		Line 34:

	== Notes ==		== Notes ==
	* ~~Planned for~~ G1R:MP 0.1.9~~; not yet publicly released and not included in public 0.1.8~~. This documents the implemented ~~development~~ API~~, not a release announcement~~. See [[Item type stats]] for scope and remaining in-game validation.		* Available from G1R:MP 0.1.9. This documents the implemented API and its current limits. See [[Item type stats]] for scope and remaining in-game validation.
	* Server-side only. Profiles affect every copy of the same type on this server, across dimensions; not individual item instances.		* Server-side only. Profiles affect every copy of the same type on this server, across dimensions; not individual item instances.
	* Use matching supported client and server builds. Server acceptance and a client application report do not prove the native gameplay effect.		* Use matching supported client and server builds. Server acceptance and a client application report do not prove the native gameplay effect.

RemovePlayerItem

QCherry — Tue, 20 Oct 2026 13:29:04 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 40:		Line 40:

	<!-- customkeys019:start -->		<!-- customkeys019:start -->
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~. Use matching updated server and clients.'''		'''Available from 0.1.9. Use matching updated server and clients.'''

	== Registered custom keys ==		== Registered custom keys ==
	This existing API also accepts the canonical item string from [[registerKeyDefinition]] in ~~upcoming~~ 0.1.9. Server registration, active definition and appropriate presentation readiness are required for mutations; use [[isPlayerKeyDefinitionReady]]. Do not pass the donor model alias as the custom item identity. Existing call shapes and limits remain; [[spawnItem]] creates one world item per call, whereas give/remove counts can manage copies. See [[Custom keys]] for safe server-side issuance, drop, pickup and persistence.		This existing API also accepts the canonical item string from [[registerKeyDefinition]] in 0.1.9. Server registration, active definition and appropriate presentation readiness are required for mutations; use [[isPlayerKeyDefinitionReady]]. Do not pass the donor model alias as the custom item identity. Existing call shapes and limits remain; [[spawnItem]] creates one world item per call, whereas give/remove counts can manage copies. See [[Custom keys]] for safe server-side issuance, drop, pickup and persistence.
	<!-- customkeys019:end -->		<!-- customkeys019:end -->

RegisterKeyDefinition

QCherry — Tue, 20 Oct 2026 13:29:02 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 1:		Line 1:
	= registerKeyDefinition =		= registerKeyDefinition =
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~. Use matching updated server and clients.'''		'''Available from 0.1.9. Use matching updated server and clients.'''

	Server Lua. Part of [[Custom keys\|custom keys and shared placed doors]].		Server Lua. Part of [[Custom keys\|custom keys and shared placed doors]].

Player identity catalog

QCherry — Tue, 20 Oct 2026 13:29:01 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:29, 20 October 2026
Line 1:		Line 1:
	{{DISPLAYTITLE:Player identity catalog}}		{{DISPLAYTITLE:Player identity catalog}}
	The '''player identity catalog''' lists named player identities accepted by [[setPlayerIdentity]]. The server commits matching identity keys together. In ~~public~~ 0.1.8, named identities use head-only presentation while retaining the game-owned body and equipped armor. From ~~upcoming~~ 0.1.9, the five [[Female identities\|supported female identities]] can also show their full authored outfit when no armor is equipped and body/head selections match. Selecting an identity does not equip or remove armor.		The '''player identity catalog''' lists named player identities accepted by [[setPlayerIdentity]]. The server commits matching identity keys together. In 0.1.8, named identities use head-only presentation while retaining the game-owned body and equipped armor. From 0.1.9, the five [[Female identities\|supported female identities]] can also show their full authored outfit when no armor is equipped and body/head selections match. Selecting an identity does not equip or remove armor.

	<div style="background:#fff5f5; border:1px solid #d13b3b; border-left:5px solid #d13b3b; color:#111; padding:0.85rem 1rem; margin:0.75rem 0 1rem;">		<div style="background:#fff5f5; border:1px solid #d13b3b; border-left:5px solid #d13b3b; color:#111; padding:0.85rem 1rem; margin:0.75rem 0 1rem;">
Line 186:		Line 186:
	<!-- female019:start -->		<!-- female019:start -->
	== Female identities (from 0.1.9) ==		== Female identities (from 0.1.9) ==
	'''Improved from 0.1.9 ~~(upcoming; not yet publicly released)~~.''' ~~This improvement is not included in public 0.1.8.~~		'''Improved from 0.1.9.'''
	The existing keys <code>syra</code>, <code>velaya</code>, <code>seraphia</code>, <code>chani</code> and <code>natalia</code> receive corrected facial proportions and matching female-body presentation. Without armor, a complete matching identity shows its authored outfit; with armor, the native armor remains visible with the corrected head. Facial expression is currently neutral. See [[Female identities]] for player/NPC examples, mixed head/body selections and limits.		The existing keys <code>syra</code>, <code>velaya</code>, <code>seraphia</code>, <code>chani</code> and <code>natalia</code> receive corrected facial proportions and matching female-body presentation. Without armor, a complete matching identity shows its authored outfit; with armor, the native armor remains visible with the corrected head. Facial expression is currently neutral. See [[Female identities]] for player/NPC examples, mixed head/body selections and limits.
	<!-- female019:end -->		<!-- female019:end -->

Player customization

QCherry — Tue, 20 Oct 2026 13:28:59 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:28, 20 October 2026
Line 33:		Line 33:
	* [[getPlayerIdentity]](<code>playerId</code>) reads the current key; [[getPlayerIdentityNames]]() lists supported identities.		* [[getPlayerIdentity]](<code>playerId</code>) reads the current key; [[getPlayerIdentityNames]]() lists supported identities.
	* Identity changes preserve equipped armor and the independent skin-color/tattoo overrides.		* Identity changes preserve equipped armor and the independent skin-color/tattoo overrides.
	* ~~Public~~ 0.1.8 uses head-only identity presentation. From ~~upcoming~~ 0.1.9, [[Female identities\|five supported female identities]] additionally show their full authored body/outfit without armor when body/head selections match. Equipped armor is preserved. This is not a body-shape or morph API.		* 0.1.8 uses head-only identity presentation. From 0.1.9, [[Female identities\|five supported female identities]] additionally show their full authored body/outfit without armor when body/head selections match. Equipped armor is preserved. This is not a body-shape or morph API.
	* Update 0.1.3 corrects head publication and material-mask restoration during identity/armor changes, including meshes with more than 64 material slots. The changes address overlapping heads and missing body parts during visual rebuilds.		* Update 0.1.3 corrects head publication and material-mask restoration during identity/armor changes, including meshes with more than 64 material slots. The changes address overlapping heads and missing body parts during visual rebuilds.

Line 124:		Line 124:
	<!-- armor019:start -->		<!-- armor019:start -->
	== Armor parts (from 0.1.9) ==		== Armor parts (from 0.1.9) ==
	~~Upcoming; not included in public~~ 0.1.8. [[Armor catalog]] lists the 26 bases; [[Armor upgrade catalog]] lists all 84 pieces. This existing function/guide is not newly introduced in 0.1.9. The new [[Armor upgrades\|upgrade system]] adds per-character top/mid/bottom selections, full presets and separate player/NPC setters. A different base clears the old parts; choosing the same base keeps compatible selections. Identity, skin tint and tattoos remain separate. See the guide for requirements, safe replacement and synchronization validation.		Available from 0.1.9. [[Armor catalog]] lists the 26 bases; [[Armor upgrade catalog]] lists all 84 pieces. This existing function/guide is not newly introduced in 0.1.9. The new [[Armor upgrades\|upgrade system]] adds per-character top/mid/bottom selections, full presets and separate player/NPC setters. A different base clears the old parts; choosing the same base keeps compatible selections. Identity, skin tint and tattoos remain separate. See the guide for requirements, safe replacement and synchronization validation.
	<!-- armor019:end -->		<!-- armor019:end -->

	<!-- female019:start -->		<!-- female019:start -->
	== Female characters (from 0.1.9) ==		== Female characters (from 0.1.9) ==
	'''Improved from 0.1.9 ~~(upcoming; not yet publicly released)~~.''' ~~This improvement is not included in public 0.1.8.~~		'''Improved from 0.1.9.'''
	Use [[setPlayerIdentity]] with <code>syra</code>, <code>velaya</code>, <code>seraphia</code>, <code>chani</code> or <code>natalia</code>. The update corrects stretched female faces, including armored characters. Complete matching identities show their female outfit without armor; equipped armor retains its original shape and takes priority. Skin tint and tattoo overrides remain independent, subject to exposed/supported skin regions. See [[Female identities]] for examples and the neutral-expression limitation. No new customization function is required.		Use [[setPlayerIdentity]] with <code>syra</code>, <code>velaya</code>, <code>seraphia</code>, <code>chani</code> or <code>natalia</code>. The update corrects stretched female faces, including armored characters. Complete matching identities show their female outfit without armor; equipped armor retains its original shape and takes priority. Skin tint and tattoo overrides remain independent, subject to exposed/supported skin regions. See [[Female identities]] for examples and the neutral-expression limitation. No new customization function is required.
	<!-- female019:end -->		<!-- female019:end -->

Player animation catalog

QCherry — Tue, 20 Oct 2026 13:28:58 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:28, 20 October 2026
Line 7:		Line 7:
	The '''player animation catalog''' lists the stable, server-validated aliases accepted by [[startAnim]]. Aliases are case-insensitive. Lua passes an alias from this table; raw Unreal asset paths are neither accepted nor exposed as API inputs.		The '''player animation catalog''' lists the stable, server-validated aliases accepted by [[startAnim]]. Aliases are case-insensitive. Lua passes an alias from this table; raw Unreal asset paths are neither accepted nor exposed as API inputs.

	'''~~Public~~ 0.1.8 includes the 118-alias catalog expanded in 0.1.4.''' These earlier entries have been confirmed working in-game; see the tables below and [[Update 0.1.4]].		'''0.1.8 includes the 118-alias catalog expanded in 0.1.4.''' These earlier entries have been confirmed working in-game; see the tables below and [[Update 0.1.4]].

	'''From ~~upcoming~~ 0.1.9: 962 aliases in total, including 844 additions.''' See the complete [[Activity animation catalog]] and [[Activity animations\|usage guide]]. The new entries include route/gesture variants and are not all individually visually confirmed. Both client and server need the matching update.		'''From 0.1.9: 962 aliases in total, including 844 additions.''' See the complete [[Activity animation catalog]] and [[Activity animations\|usage guide]]. The new entries include route/gesture variants and are not all individually visually confirmed. Both client and server need the matching update.

	== Request modes ==		== Request modes ==
Line 331:		Line 331:
	<!-- activities019:start -->		<!-- activities019:start -->
	== Activity expansion (from 0.1.9) ==		== Activity expansion (from 0.1.9) ==
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released)~~.''' ~~Not included in public 0.1.8.~~ Both the server and observing clients need the matching update.		'''Available from 0.1.9.''' Both the server and observing clients need the matching update.
	[[Activity animation catalog]] lists all 844 new aliases with recommended modes and timing: gathering, rice/herb processing, work, crafting gestures, fishing, rest, daily activities, carrying, poses and gestures. [[Activity animations]] includes examples for players and NPCs, all six fishing aliases, cosmetic rod handling and qualification limits. The original 118 aliases remain available.		[[Activity animation catalog]] lists all 844 new aliases with recommended modes and timing: gathering, rice/herb processing, work, crafting gestures, fishing, rest, daily activities, carrying, poses and gestures. [[Activity animations]] includes examples for players and NPCs, all six fishing aliases, cosmetic rod handling and qualification limits. The original 118 aliases remain available.
	<!-- activities019:end -->		<!-- activities019:end -->

OnWorldItemPickup

QCherry — Tue, 20 Oct 2026 13:28:56 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:28, 20 October 2026
Line 48:		Line 48:

	<!-- customkeys019:start -->		<!-- customkeys019:start -->
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~. Use matching updated server and clients.'''		'''Available from 0.1.9. Use matching updated server and clients.'''

	== Custom-key pickup ==		== Custom-key pickup ==
	The existing <code>(objectId, playerId, item, quantity, serverTimeMs)</code> event also reports registered custom keys using their canonical identity. Inventory was already granted by the core; do not give it again. Persist your gamemode inventory as needed. This is a reserved server notification, not remotely triggerable. See [[Custom keys]].		The existing <code>(objectId, playerId, item, quantity, serverTimeMs)</code> event also reports registered custom keys using their canonical identity. Inventory was already granted by the core; do not give it again. Persist your gamemode inventory as needed. This is a reserved server notification, not remotely triggerable. See [[Custom keys]].
	<!-- customkeys019:end -->		<!-- customkeys019:end -->

OnWorldItemDropCommitted

QCherry — Tue, 20 Oct 2026 13:28:55 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:28, 20 October 2026
Line 1:		Line 1:
	= onWorldItemDropCommitted =		= onWorldItemDropCommitted =
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~. Use matching updated server and clients.'''		'''Available from 0.1.9. Use matching updated server and clients.'''

	Server-side event, handled on root. All resources running at commit. Deferred notification after the pending drop was committed and its world object published. No extra inventory deduction or completion call is needed. Fields are numbers except canonical item string; timestamp is server monotonic milliseconds captured when the drop was created.		Server-side event, handled on root. All resources running at commit. Deferred notification after the pending drop was committed and its world object published. No extra inventory deduction or completion call is needed. Fields are numbers except canonical item string; timestamp is server monotonic milliseconds captured when the drop was created.

OnWorldItemDropCancelled

QCherry — Tue, 20 Oct 2026 13:28:54 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:28, 20 October 2026
Line 1:		Line 1:
	= onWorldItemDropCancelled =		= onWorldItemDropCancelled =
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~. Use matching updated server and clients.'''		'''Available from 0.1.9. Use matching updated server and clients.'''

	Server-side event, handled on root. Captured persistence owner only. Deferred notification after cancellation of a pending drop. The core handles live rollback for a still-connected player; your gamemode owns durable inventory recovery. Do not grant the quantity again. Timestamp is the original drop creation time.		Server-side event, handled on root. Captured persistence owner only. Deferred notification after cancellation of a pending drop. The core handles live rollback for a still-connected player; your gamemode owns durable inventory recovery. Do not grant the quantity again. Timestamp is the original drop creation time.

OnWorldItemDrop

QCherry — Tue, 20 Oct 2026 13:28:52 GMT

Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits

← Older revision		Revision as of 13:28, 20 October 2026
Line 49:		Line 49:

	<!-- customkeys019:start -->		<!-- customkeys019:start -->
	'''Available from 0.1.9 ~~(upcoming; not yet publicly released). Not included in public 0.1.8~~. Use matching updated server and clients.'''		'''Available from 0.1.9. Use matching updated server and clients.'''

	== Custom-key pending drop requests ==		== Custom-key pending drop requests ==
	Signature remains <code>(objectId, playerId, item, quantity, serverTimeMs)</code>. For custom keys, only the defining resource receives this pre-commit persistence request. The quantity is already deducted; object publication/pickup is quarantined until [[completeWorldItemDrop]]. Other resources should use [[onWorldItemDropCommitted]] for custom-key observation. Existing ordinary-item GothicRP/observer behavior is preserved. See [[Custom keys#Drop, pickup and persistence\|full contract]].		Signature remains <code>(objectId, playerId, item, quantity, serverTimeMs)</code>. For custom keys, only the defining resource receives this pre-commit persistence request. The quantity is already deducted; object publication/pickup is quarantined until [[completeWorldItemDrop]]. Other resources should use [[onWorldItemDropCommitted]] for custom-key observation. Existing ordinary-item GothicRP/observer behavior is preserved. See [[Custom keys#Drop, pickup and persistence\|full contract]].
	<!-- customkeys019:end -->		<!-- customkeys019:end -->