docs(reference): preserve local ACE command catalog

This commit is contained in:
Erik 2026-07-27 00:03:58 +02:00
parent 5b3fb17775
commit 456c72233e
3 changed files with 317 additions and 0 deletions

View file

@ -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 [`superpowers/plans/`](superpowers/plans/) are per-slice design and execution
records. Completed plans remain historical. records. Completed plans remain historical.
- [`audit/`](audit/) contains completion and conformance audits. - [`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 ## Durable memory

View file

@ -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 <command>` 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.
```

View file

@ -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 <command>` 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.