From 456c72233eecd4f77663bc12c08e4a34890beb52 Mon Sep 17 00:00:00 2001 From: Erik Date: Mon, 27 Jul 2026 00:03:58 +0200 Subject: [PATCH] docs(reference): preserve local ACE command catalog --- docs/README.md | 3 + docs/reference/ace-commands.md | 288 +++++++++++++++++++++++++++++++ memory/reference_ace_commands.md | 26 +++ 3 files changed, 317 insertions(+) create mode 100644 docs/reference/ace-commands.md create mode 100644 memory/reference_ace_commands.md diff --git a/docs/README.md b/docs/README.md index 60acd764..860526e5 100644 --- a/docs/README.md +++ b/docs/README.md @@ -82,6 +82,9 @@ document in the same change; do not leave both claims standing. [`superpowers/plans/`](superpowers/plans/) are per-slice design and execution records. Completed plans remain historical. - [`audit/`](audit/) contains completion and conformance audits. +- [`reference/ace-commands.md`](reference/ace-commands.md) preserves the local + ACE server's complete in-game command catalog and points to the authoritative + per-command help surface. ## Durable memory diff --git a/docs/reference/ace-commands.md b/docs/reference/ace-commands.md new file mode 100644 index 00000000..1bfd34f1 --- /dev/null +++ b/docs/reference/ace-commands.md @@ -0,0 +1,288 @@ +# ACE in-game command reference + +Captured from the local ACE server's `@acecommands` output on 2026-07-26. +This is a server-version-specific working reference; use +`@acehelp ` in game for the exact syntax and arguments supported by +the running server. + +`@` and `/` are interchangeable command prefixes in Asheron's Call. + +```text +For more information, type @acehelp < command >. +@accountcreate - Creates a new account. +@acecommands - Lists all commands. +@acehelp - Displays help. +@aceversion - Shows this server's version data +@addallspells - Adds all known spells to your own spellbook. +@addalltitles - Add all titles to yourself +@addenc - Spawns a new wcid or classname in the current outdoor cell as an encounter +@additemspell - Adds a spell to the last appraised item's spellbook. +@addspell - Adds the specified spell to your own spellbook. +@addtitle - Add title to yourself +@adminhouse - House management tools for admins. +@adminui - +@adminvision - Allows the admin to see admin-only visible items. +@allstats - Displays a summary of all server statistics and usage +@animation - Plays an animation on the current player, or optionally another object +@attackable - Sets whether monsters will attack you or not. +@auditobjectmaint - Iterates over physics objects to find leaks +@ban - Bans the specified player account. +@banlist - Lists all banned accounts on this world. +@barbershop - Displays the barber ui +@barrier-test - Shows debug information for house barriers +@bestow - Sets a character's Advocate Level. +@boot - Boots the character out of the game. +@bornagain - Restores a deleted character to an account. +@buff - Buffs you (or a player) with all beneficial spells. +@bumpvelocity - Bumps the velocity of the last appraised object. +@cancel-shutdown - Stops an active server shutdown. +@castmeter - Shows the fast casting efficiency meter +@castspell - Casts a spell on the last appraised object +@chatdump - Spews 1000 lines of text to you. +@check-collision - Checks if the player is currently colliding with any other objects. +@ci - Creates an object in your inventory. +@ciaetheria - Spawns an Aetheria in the player's inventory +@ciloot - Generates randomized loot in player's inventory +@cirand - Creates random objects in your inventory. +@cisalvage - Create a salvage bag in your inventory +@clearcache - Clears the various database caches. This enables live editing of the database information +@clearphysicscaches - Clears Physics Object Caches +@cloak - Sets your cloaking state. +@cm - Create a salvage bag in your inventory +@comps - Creates spell component items in your inventory for testing. +@config - Manually sets a character option on the server. +Use /config list to see a list of settings. +@contract - Query, stamp, and erase contracts on the targeted player +@copychar - Copies an existing character into your character list. +@crack - Cracks the most recently appraised locked target. +@create - Creates an object or objects in the world. +@createinst - Spawns a new wcid or classname as a landblock instance +@createliveops - Creates an object or objects with lifespans in the world for live events. +@createnamed - Creates a named object in the world. +@currency - Creates some currency items in your inventory for testing. +@damagehistory - +@database-shard-cache-npbrt - Shard Database, Non-Player Biota Cache - Retention Time (in minutes) +@database-shard-cache-pbrt - Shard Database, Player Biota Cache - Retention Time (in minutes) +@databaseperftest - Test server/database performance. +@databasequeueinfo - Show database queue information. +@de_n - Sends text to named player, formatted exactly as entered. +@de_s - Sends text to selected player, formatted exactly as entered, with no prefix of any kind. +@deaf - +@deathxp - Displays how much experience the last appraised creature is worth when killed. +@debugboard - Shows the current chess board state +@debugcast - Shows debug information about the current magic casting state +@debugchess - Shows the chess move history for a player +@debugdamage - Toggles the display for player damage info +@debugemote - Enables emote debugging for the last appraised object +@debugmove - Toggles movement debugging for the last appraised monster +@debugspell - Toggles spell projectile debugging info +@debugspellbook - Shows the spellbook for the last appraised object +@delete - Deletes the selected object. +@deletecharacter - Deletes a character and removes it from players restore list +@delevel - Attempts to delevel the current player. Requires enough unassigned xp and unspent skill credits. +@destructionqueue - Shows the list of previously visible objects queued for destruction for a player +@direct_emote_name - Sends text to named player, formatted exactly as entered. +@direct_emote_select - Sends text to selected player, formatted exactly as entered, with no prefix of any kind. +@dispel - Removes all enchantments from the player +@dist - Returns the distance to the last appraised object +@draw - +@dumpattackers - +@dungeonname - Shows the dungeon name for the current landblock +@echo - Send text back to yourself. +@echoflags - Echo flags back to you +@effect - Plays an effect. +@enable-aetheria - Enables the aetheria slots for the player +@equiptest - Simulates equipping a new item to your character, replacing all other items. +@event - Maniuplates the state of an event +@export-json - Exports content from database to JSON file +@export-sql - Exports content from database to SQL file +@faction - sets your own faction state. +@fast - +@fellow-dist - Shows distance to each fellowship member +@fellow-info - Shows debug info for fellowships. +@fellowbuff - Buffs your fellowship (or a player's fellowship) with all beneficial spells. +@fetchbool - Fetches a server property that is a bool +@fetchdouble - Fetches a server property that is a double +@fetchlong - Fetches a server property that is a long +@fetchstring - Fetches a server property that is a string +@finger - Show the given character's account name or vice-versa. +@fixbusy - Attempts to remove the hourglass / fix the busy state for the player +@fixcast - Fixes magic casting if locked up for an extended time +@food - Creates some food items in your inventory for testing. +@forcegc - Forces .NET Garbage Collection +@forcelogoff - Force log off of specified character or last appraised character +@forcelogout - Force log off of specified character or last appraised character +@freeze - +@fumble - +@gag - Prevents a character from talking. +@gamecast - Sends a world-wide broadcast. +@gamecastemote - Sends text to all players, formatted exactly as entered. +@gamecastlocal - Sends a server-wide broadcast. +@gamecastlocalemote - Sends text to all players within chat range, formatted exactly as entered. +@gcstatus - Displays a summary of server GC Information +@generate-classnames - Generates WeenieClassName.cs from current world database +@generatordump - Lists all properties for the last generator you examined. +@getenchantments - Shows the enchantments for the last appraised item +@getinfo - Shows basic info for the last appraised object. +@getproperty - Gets a property for the last appraised object +@givemana - Gives mana to the last appraised object +@god - Turns current character into a god! +@gps - Display location. +@grantitemxp - Give item XP to the last appraised item. +@grantluminance - Give luminance to yourself (or the specified character). +@grantxp - Give XP to yourself (or the specified character). +@harmself - Sets all player vitals to 1 +@heal - Heals yourself (or the selected creature) +@home - Teleports you to your sanctuary position. +@house-select - For characters/accounts who currently own multiple houses, used to select which house they want to keep +@housekeep - +@idlist - Shows the next ID that will be allocated from GuidManager. +@import-json - Imports json data from the Content folder +@import-sql - Imports sql data from the Content folder +@inv - Creates sample items, foci and containers in your inventory. +@knownobjs - Shows the list of objects currently known to an object +@knownplayers - Shows the list of players known to an object +@landblockperformance - Displays a summary of landblock performance statistics +@lbinterval - +@lbthresh - +@limbo - +@listplayers - Displays all of the active players connected too the server. +@listpositions - Displays all available saved character positions from the database. +@loadalllandblocks - Loads all Landblocks. This is VERY crude. Do NOT use it on a live server!!! It will likely crash the server. Landblock resources will be loaded async and will continue to do work even after all landblocks have been loaded. +@location - +@lootgen - Generate a piece of loot from the LootGenerationFactory. +@lostest - Tests for direct visibilty with latest appraised object +@magic god - +@makeiou - Make an IOU and put it in your inventory +@modifyattr - Adjusts an attribute for the last appraised mob/NPC/player +@modifybool - Modifies a server property that is a bool +@modifydouble - Modifies a server property that is a double +@modifylong - Modifies a server property that is a long +@modifypropertydesc - Modifies a server property's description +@modifyskill - Adjusts the skill for the last appraised mob/player +@modifystring - Modifies a server property that is a string +@modifyvital - Adjusts the maximum vital attribute for the last appraised mob/player and restores full vitals +@monsterspell - The last appraised creature casts a spell. For targeted spells, defaults to the current player. +@morph - Morphs your bodily form into that of the specified creature. Be careful with this one! +@movement - Movement testing command, to be removed soon +@MoveTo - Used to test the MoveToObject message. It will spawn a training wand in front of you and then move to that object. +@movetome - Moves the last appraised object to the current player location. +@mrt - Toggles the ability to bypass housing boundaries +@myiid - Displays your Instance ID (IID) +@myloc - Shows the current player location, from the server perspective +@myquests - Shows your quest log +@myserver - +@netstats - View network statistics +@neversaydie - Turn immortality on or off. +@nudge - Adjusts the spawn position of a landblock instance +@objsend - Force resend of all visible objects known to this player. Can fix rare cases of invisible object bugs. Can only be used once every 5 mins max. +@passwd - Change your account password. +@pk - sets your own PK state. +@pktimer - Sets your PK timer to the current time +@playsound - Plays a sound. +@pop - Show current world population +@portal_bypass - Toggles the ability to bypass portal restrictions. +@propertydump - Lists all properties for the last world object you examined. +@pscript - +@purchase-house - Instantly purchase the house for the last appraised covenant crystal. +@qst - Query, stamp, and erase quests on the targeted player +@queryplugin - +@querypluginlist - +@radar - +@raise - +@rares dump - +@recordcast - Records spell casting keypresses to server for debugging +@regen - Sends the selected generator a regeneration message. +@reload-landblock - Reloads the current landblock. +@reload-loot-tables - reloads the latest data from the loot tables +@reloadsysmsg - +@remove - Removes the specified character from the Advocate ranks. +@remove-vitae - Removes vitae from last appraised player +@removeenc - Removes the last appraised object from the encounters table +@removeinst - Removes the last appraised object from the current landblock instances +@removeitemspell - Removes a spell to the last appraised item's spellbook. +@removespell - Removes the specified spell to your own spellbook. +@rename - Rename a character. (Do NOT include +'s for admin names) +@repeat - +@reportbug - Generate a Bug Report +@requirecomps - Sets whether spell components are required to cast spells. +@resist-info - Shows the resistance info for the last appraised creature. +@resyncproperties - Resync the properties database +@retaliatetargets - Shows the list of retaliate targets for a monster +@rip - +@rotate - Adjusts the rotation of a landblock instance +@run - Temporarily boosts your run skill. +@safecomps - Enables / disables spell component burning +@save - Sets your sanctuary position or a named recall point. +@save-now - Saves your session. +@serverlist - +@serverperformance - Displays a summary of server performance statistics +@serverstatus - Displays a summary of server statistics and usage +@set-accountaccess - Change the access level of an account. +@set-accountpassword - Set the account password. +@set-characteraccess - Sets the access level for the character +@set-shutdown-interval - Changes the delay, in seconds, before the server will shutdown. +@setadvclass - +@setcoin - Set Coin display debug only usage +@setglobalenviron - Sets or clears server's global environment option +@sethealth - sets your current health to a specific value. +@setlbenviron - Sets or clears your current landblock's environment option +@setposition - Saves the supplied character position type to the database. +@setproperty - Sets a property for the last appraised object +@setpurchasetime - Sets the house purchase time for this player +@setvital - Sets the specified vital to a specified value +@show-allegiances - Shows all of the allegiance chains on the server. +@show-wielded-treasure - Shows the WieldedTreasure table for a Creature +@showprops - Displays the name of all properties configurable via the modify commands +@showsession - Show IP and ID for network session of last appraised character +@showstats - Shows a list of a creature's current attribute/skill levels +@showtier - Shows the DeathTreasure tier for the last appraised monster +@showvelocity - Shows the velocity of the last appraised object. +@shutdown - Begins the server shutdown process. Optionally displays a shutdown message, if a string is passed. +@slow - +@smite - Kills the selected target or all monsters in radar range if "all" is specified. +@snoop - +@spendallxp - Spend all available XP on Attributes, Vitals and Skills. +@spendxp - +@splits - Creates some stackable items in your inventory for testing. +@sticky - Sets whether you lose items should you die. +@stop-now - Shuts the server down, immediately! +@stormnumstormed - +@stormthresh - +@targetloc - Shows the location of the last appraised object +@tele - Teleports you(or a player) to some location. +@teleallto - Teleports all players to a player. If no target is specified, all players will be teleported to you. +@teledist - Teleports a some distance ahead of the last object spawned +@teledungeon - Teleport to a dungeon +@teleloc - Teleport yourself to the specified location. +@telepoi - Teleport yourself to a named Point of Interest +@telereturn - Return a player to their previous location. +@teleto - Teleport yourself to a player +@teletome - Teleports a player to your current location. +@teletype - Teleport to a saved character position. +@telexyz - Teleport to a location. +@testaim - Tests the aim high/low motions, and projectile spawn position +@testdeathitems - Test death item selection +@tiermobs - Shows a list of monsters for a particular tier # +@time - Displays the server's current game time. +@trainskill - +@trophies - Shows a list of the trophies dropped by the target creature, and the percentage chance of dropping. +@trywield - +@turnto - Turns the last appraised object to the player +@unban - Unbans the specified player account. +@unfreeze - +@ungag - Allows a gagged character to talk again. +@ungod - Returns character to a mortal state. +@unlock - +@userlimit - +@vendordump - Lists all properties for the last vendor you examined. +@visibleobjs - Shows the list of objects currently visible to an object +@visibleplayers - Shows the list of players visible to a player +@visibletargets - Shows the list of targets currently visible to a monster +@vloc2loc - Output a set of LOCs for a given landblock found in the VLOCS dataset +@watchmen - Displays a list of accounts with the specified level of admin access. +@we - Sends text to all players, formatted exactly as entered. +@weapons - Creates testing items in your inventory. +@whoami - Shows you your GUIDs. +@world - Open or Close world to player access. +``` diff --git a/memory/reference_ace_commands.md b/memory/reference_ace_commands.md new file mode 100644 index 00000000..b9599360 --- /dev/null +++ b/memory/reference_ace_commands.md @@ -0,0 +1,26 @@ +--- +name: reference_ace_commands +description: "Local ACE server command catalog and durable test-state cautions." +tags: [ace, commands, server, testing, reference] +--- + +# ACE command reference + +The local server's complete `@acecommands` output is preserved at +[`docs/reference/ace-commands.md`](../docs/reference/ace-commands.md). +Use `@acehelp ` against the running server for exact syntax because +the command catalog is server-version-specific. + +## Persistent test-state cautions + +- `@attackable` toggles whether monsters attack the current character. The + value is server-side and persists across clients, so retail reproduces the + same immunity. Toggle it back after tests that disable it. +- `@god` is a persistent and potentially destructive character conversion, + not a temporary client diagnostic. Prefer a disposable test character and + use `@ungod` only with the server's documented recovery caveats. +- `@neversaydie`, `@cloak`, `@mrt`, `@portal_bypass`, and similar toggles can + also survive long enough to invalidate client comparisons. When retail and + acdream reproduce the same symptom on the same character, audit ACE state + before attributing it to client code. +- `@` and `/` are interchangeable command prefixes in AC.