rom24-quickmud-python 2.9.19__py3-none-any.whl → 2.9.21__py3-none-any.whl

mud/commands/group_commands.py

@@ -259,16 +259,45 @@ def do_group(char: Character, args: str) -> str:
     if char_affected & AffectFlag.CHARM:
         return "You like your master too much to leave!"
 
-    # Already in group - remove
+    leader_name = _display_name(char)
+    victim_name_str = _display_name(victim)
+
+    # Already in group - remove (ROM src/act_comm.c:1838-1847)
     if is_same_group(victim, char) and char is not victim:
         victim.leader = None
-        victim_name = getattr(victim, "short_descr", None) or getattr(victim, "name", "them")
-        return f"You remove {victim_name} from your group."
-
-    # Add to group
+        # TO_VICT: "$n removes you from $s group."
+        victim_messages = getattr(victim, "messages", None)
+        if isinstance(victim_messages, list):
+            victim_messages.append(f"{leader_name} removes you from {leader_name}'s group.")
+        # TO_NOTVICT: "$n removes $N from $s group."
+        room = getattr(char, "room", None)
+        if room is not None:
+            notvict_msg = f"{leader_name} removes {victim_name_str} from {leader_name}'s group."
+            for occupant in list(getattr(room, "people", []) or []):
+                if occupant is char or occupant is victim:
+                    continue
+                occ_messages = getattr(occupant, "messages", None)
+                if isinstance(occ_messages, list):
+                    occ_messages.append(notvict_msg)
+        return f"You remove {victim_name_str} from your group."
+
+    # Add to group (ROM src/act_comm.c:1850-1854)
     victim.leader = char
-    victim_name = getattr(victim, "short_descr", None) or getattr(victim, "name", "someone")
-    return f"{victim_name} joins your group."
+    # TO_VICT: "You join $n's group."
+    victim_messages = getattr(victim, "messages", None)
+    if isinstance(victim_messages, list):
+        victim_messages.append(f"You join {leader_name}'s group.")
+    # TO_NOTVICT: "$N joins $n's group."
+    room = getattr(char, "room", None)
+    if room is not None:
+        notvict_msg = f"{victim_name_str} joins {leader_name}'s group."
+        for occupant in list(getattr(room, "people", []) or []):
+            if occupant is char or occupant is victim:
+                continue
+            occ_messages = getattr(occupant, "messages", None)
+            if isinstance(occ_messages, list):
+                occ_messages.append(notvict_msg)
+    return f"{victim_name_str} joins your group."
 
 
 def do_gtell(char: Character, args: str) -> str:

mud/models/object.py

@@ -166,3 +166,41 @@ def create_object(prototype: ObjIndex, *, instance_id: int | None = None) -> Obj
     obj = Object(instance_id=instance_id, prototype=prototype)
     object_registry.append(obj)
     return obj
+
+
+def recursive_clone(obj: Object, clone_to: Object | None = None) -> Object:
+    """Deep-clone *obj* including container contents.
+
+    ROM parity: src/act_wiz.c:recursive_clone (line 2320). Used by the
+    immortal ``clone`` command and OLC paths.
+    """
+    from mud.models.obj import ObjIndex
+
+    if not obj.prototype:
+        proto = ObjIndex(
+            vnum=obj.vnum,
+            name=obj.name,
+            short_descr=obj.short_descr,
+            long_descr=obj.long_descr,
+            description=obj.description,
+            item_type=obj.item_type,
+            extra_flags=obj.extra_flags,
+            wear_flags=obj.wear_flags,
+            value=obj.value.copy() if obj.value else [0, 0, 0, 0, 0],
+            weight=obj.weight,
+            cost=obj.cost,
+            level=obj.level,
+        )
+    else:
+        proto = obj.prototype
+
+    new_obj = create_object(proto)
+
+    for content in obj.contained_items:
+        recursive_clone(content, new_obj)
+
+    if clone_to:
+        clone_to.contained_items.append(new_obj)
+        new_obj.location = None
+
+    return new_obj

mud/world/look.py

@@ -53,7 +53,7 @@ def look(char: Character, args: str = "") -> str:
         return "You can't see anything, you're sleeping!"
 
     # Check blind - ROM src/act_info.c lines 1065-1066
-    from mud.rom_api import check_blind
+    from mud.world.vision import check_blind
 
     if not check_blind(char):
         return "You can't see a thing!"

mud/world/vision.py

@@ -371,3 +371,22 @@ def describe_character(observer: Character, target: Character | None) -> str:
         return " ".join(prefixes) + " " + base_name
 
     return base_name
+
+
+def check_blind(char: Character) -> bool:
+    """Return True when *char* is not blinded, False otherwise.
+
+    ROM parity: src/act_info.c:check_blind (line 542).
+    """
+    checker = getattr(char, "has_affect", None)
+    if callable(checker):
+        try:
+            return not bool(checker(AffectFlag.BLIND))
+        except Exception:
+            pass
+
+    affected = getattr(char, "affected_by", 0)
+    try:
+        return not bool(int(affected) & int(AffectFlag.BLIND))
+    except Exception:
+        return True

{rom24_quickmud_python-2.9.19.dist-info → rom24_quickmud_python-2.9.21.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rom24-quickmud-python
-Version: 2.9.19
+Version: 2.9.21
 Summary: A modern Python port of the ROM 2.4b6 MUD engine with full telnet server and JSON world loading
 Author-email: Mark Jedrzejczyk <mark.jedrzejczyk@gmail.com>
 Maintainer-email: Mark Jedrzejczyk <mark.jedrzejczyk@gmail.com>

{rom24_quickmud_python-2.9.19.dist-info → rom24_quickmud_python-2.9.21.dist-info}/RECORD

@@ -11,7 +11,6 @@ mud/mob_cmds.py,sha256=Hv7tFhABraQLRbQihHOHTDE4qgE0GSuue1_RQkchQW4,46158
 mud/mobprog.py,sha256=TZiv4ZErFAlcO1TWaJryzZ5kwTZFe5DSqKVlo6qJcTc,59173
 mud/notes.py,sha256=mJM_f1lQ-Y1us7MHzHkgfozYKQCBm84FKRjmKpgoiOE,11501
 mud/registry.py,sha256=s8tGVKLZUU6-5c7HtBqhHQWLVxzFM4A9bpJ8avGt_0I,306
-mud/rom_api.py,sha256=4XIQZvWt6oNLiUBGr-NShCQ3Ev9nSEMGNh01VPowagA,17256
 mud/server.py,sha256=fv6mprd4h9CejTt8kOFkt6RA-NdzTwOd24d_3p9aOKY,219
 mud/spec_funs.py,sha256=D4x9el8po1FYDY8ZbPwDkJ4ujtIq7fEW1lCvJW8POdk,47536
 mud/time.py,sha256=eVMXzVoi9w7gGE7bN1FVYjCwSwBydSpkkVtptV4qTtw,1324
@@ -59,7 +58,7 @@ mud/commands/doors.py,sha256=KWMQPVJHs8-xPFE08kStOOU9x5ugN5sEFuo7nlQL2Z8,19777
 mud/commands/equipment.py,sha256=BXUJhe_volohdgUKpugV8Wfcn-pHXG6ooaKeF6LmcI4,22882
 mud/commands/feedback.py,sha256=qEmUlVy1KC6ludpAREdqvf8gpa8jmgN4AMLor0EoO7E,2472
 mud/commands/give.py,sha256=BcZjqFm1WqhoRi9qZJ8G9zRu_buXptwg9Y7_oSNnFVE,8787
-mud/commands/group_commands.py,sha256=_9KroYmWxm3CfvhJj5iFEw1szXS-UlGIe8YiOm3IVU8,18627
+mud/commands/group_commands.py,sha256=Cz3LNTCccR4ghpyE5QORDlZBwpzkli93uueF3zZBoHk,20077
 mud/commands/healer.py,sha256=noZ3t97C_0j1GEJd8nUNYYv4clHxuD4dvFSR3c1gfUA,7576
 mud/commands/help.py,sha256=GfQWy6MyFtDc-mW1dM7pPN1SFVsWtIGno8uR4dRQYjg,11124
 mud/commands/imc.py,sha256=v1lPP2xDjQjkk7negwjCXJtcRPQkBEIGWmpPKf1XPzU,12204
@@ -147,7 +146,7 @@ mud/models/mob.py,sha256=d2JGyNh74c-FQYmFQPXN9M9sb3valppaDRLUe49cMcc,3830
 mud/models/note.py,sha256=stKuDsBJ5UQHngPVRbgDH4me_6RtUgjRczC2X3jbhgI,653
 mud/models/note_json.py,sha256=BuYWIGyZFevoObHGknfMOxjpL0laP7G070wNPZLccXU,320
 mud/models/obj.py,sha256=VNVKGLR9uUFOlGnLeFjRaeH4sAXE_gtyJV43lz4UVuY,2141
-mud/models/object.py,sha256=0dtGzbErRPBARyR0IHtlyVMttUAkTzOU5EzGcbLzSQ0,6540
+mud/models/object.py,sha256=9KLQ8xL5cA9yC7uyrf5d8fH_ugfWVqbDwXtzSfzHqKw,7628
 mud/models/object_json.py,sha256=v1_FnQnvkGBM1lnXPWQARfDQrs20C5mZDhCaLYgNiZs,960
 mud/models/player_json.py,sha256=YQerAs3vxyAo7wr3orCXCC-pM_QWiwbz3aQ9RMzWW-Q,1249
 mud/models/races.py,sha256=U-77PyNogpyLEhdHrwA8Yll3ekBBTYKYfj-l26Catm4,17138
@@ -210,15 +209,15 @@ mud/utils/text.py,sha256=_HWbi7RAneH8EUZTkx6yKn8ngEpCwKgW_wcTlNJihE0,4357
 mud/world/__init__.py,sha256=HDEHtULHu1OWjOa3xglmhquW8L6NkJTWzLEURJ4BQjk,263
 mud/world/char_find.py,sha256=WdzbnOhydQfKIhhtDFQ8IhcYGT-HlwXrR7pjRFjtNFk,3283
 mud/world/linking.py,sha256=mxEvgqA9Y6sDGXxN46aauU-jBhx4dOUcbgq64fIVz8g,1169
-mud/world/look.py,sha256=XSsTsmAxawVz17A_28eIwosUGNkWE8T7u8hGdo57mCs,13365
+mud/world/look.py,sha256=Hocwuzi8sDCBcVaklj1WtWnAs5zRzGGkqC5B-3JCZf0,13370
 mud/world/movement.py,sha256=YdeVZXM_h0RDNyQGK7zuz_2Ld5h5m7IDKpgbRCGJK20,23231
 mud/world/obj_find.py,sha256=tgnUkbFjnCl586Lzl6yRzCmllZSNEfQpQlrxCMVcUGU,5295
 mud/world/time_persistence.py,sha256=K4uhRpu08IDHY5uReBYTvw4BHuqsSxWvbv-h1VsPvf8,1663
-mud/world/vision.py,sha256=NRk3cvrGyyldU4W98qAVlYZp9wL-IUE1dTgk6DpM-NA,11609
+mud/world/vision.py,sha256=EOw_HQdVXBCvry0lReA0ZhxSt0VL59ME-ua92oNYTAc,12128
 mud/world/world_state.py,sha256=3KpiDP6v24sZDn9-g44UypXpegzgRShHo1XvektJzdU,8810
-rom24_quickmud_python-2.9.19.dist-info/licenses/LICENSE,sha256=anQ2j9As6sIC8tZgQCXbo0-09JDH9vPiqhA9djnOvkY,1078
-rom24_quickmud_python-2.9.19.dist-info/METADATA,sha256=NSFn4LIyR0pjXXeGRQ4L6mSzo2Ym-I3BC3z3tRS0n98,15671
-rom24_quickmud_python-2.9.19.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-rom24_quickmud_python-2.9.19.dist-info/entry_points.txt,sha256=VFru08UQTXZA_CkK-NBjJmWHyEX5a3864fQHjhaojbw,41
-rom24_quickmud_python-2.9.19.dist-info/top_level.txt,sha256=Fk1WPmabIIjp7_iZXLYpbAVqiq7lG7TeAHt30AsOKtQ,4
-rom24_quickmud_python-2.9.19.dist-info/RECORD,,
+rom24_quickmud_python-2.9.21.dist-info/licenses/LICENSE,sha256=anQ2j9As6sIC8tZgQCXbo0-09JDH9vPiqhA9djnOvkY,1078
+rom24_quickmud_python-2.9.21.dist-info/METADATA,sha256=C-Kmz3VPkEIQTWAs2rX6uMbGAA4U-4Gm9C-l8gkjRxk,15671
+rom24_quickmud_python-2.9.21.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+rom24_quickmud_python-2.9.21.dist-info/entry_points.txt,sha256=VFru08UQTXZA_CkK-NBjJmWHyEX5a3864fQHjhaojbw,41
+rom24_quickmud_python-2.9.21.dist-info/top_level.txt,sha256=Fk1WPmabIIjp7_iZXLYpbAVqiq7lG7TeAHt30AsOKtQ,4
+rom24_quickmud_python-2.9.21.dist-info/RECORD,,

mud/rom_api.py

@@ -1,690 +0,0 @@
-"""
-ROM 2.4 Parity API - Public wrapper functions for ROM C compatibility.
-
-This module provides ROM C-compatible public API functions that wrap existing
-Python implementations. These wrappers use ROM C naming conventions for
-compatibility with external tools and documentation.
-
-ROM Reference: src/board.c, src/olc_act.c, src/handler.c
-"""
-
-from __future__ import annotations
-
-from typing import TYPE_CHECKING
-
-if TYPE_CHECKING:
-    from mud.models.board import Board
-    from mud.models.character import Character
-    from mud.models.note import Note
-    from mud.models.object import Object
-
-
-# =============================================================================
-# Board System Public API (src/board.c)
-# =============================================================================
-
-
-def board_lookup(name: str) -> Board | None:
-    """Find board by name.
-
-    ROM parity: src/board.c:board_lookup (line 201)
-
-    Args:
-        name: Board name to search for (case-insensitive)
-
-    Returns:
-        Board object if found, None otherwise
-    """
-    from mud.notes import find_board
-
-    return find_board(name)
-
-
-def board_number(board_name: str) -> Board | None:
-    """Get board by name (alias for board_lookup).
-
-    ROM parity: src/board.c:board_number (line 189)
-
-    Note: ROM C used numeric board IDs. Python uses names directly,
-    so this is an alias for board_lookup for API compatibility.
-
-    Args:
-        board_name: Board name to retrieve
-
-    Returns:
-        Board object if found, None otherwise
-    """
-    from mud.notes import find_board
-
-    return find_board(board_name)
-
-
-def is_note_to(char: Character, note: Note) -> bool:
-    """Check if character can read a note.
-
-    ROM parity: src/board.c:is_note_to (line 408)
-
-    Checks if note is addressed to character based on:
-    - Note recipient list (to_list)
-    - Character name match
-    - "all" recipient
-
-    Args:
-        char: Character to check visibility for
-        note: Note to check
-
-    Returns:
-        True if character can read note, False otherwise
-    """
-    from mud.commands.notes import _is_note_visible_to
-
-    return _is_note_visible_to(char, note)
-
-
-def note_from(note: Note) -> str:
-    """Get note sender name.
-
-    ROM parity: src/board.c (note->sender field access pattern)
-
-    Args:
-        note: Note to get sender from
-
-    Returns:
-        Sender name string
-    """
-    return note.sender
-
-
-# =============================================================================
-# Board Commands Public API (src/board.c)
-# =============================================================================
-
-
-def do_ncatchup(char: Character, args: str = "") -> str:
-    """Mark all notes on current board as read.
-
-    ROM parity: src/board.c:do_ncatchup (line 690)
-
-    Args:
-        char: Character executing command
-        args: Command arguments (unused)
-
-    Returns:
-        Command result message
-    """
-    from mud.commands.notes import do_note
-
-    return do_note(char, "catchup")
-
-
-def do_nremove(char: Character, args: str) -> str:
-    """Remove a note from the board.
-
-    ROM parity: src/board.c:do_nremove (line 615)
-
-    Args:
-        char: Character executing command
-        args: Note number to remove
-
-    Returns:
-        Command result message
-    """
-    from mud.commands.notes import do_note
-
-    return do_note(char, f"remove {args}")
-
-
-def do_nwrite(char: Character, args: str = "") -> str:
-    """Start writing a new note.
-
-    ROM parity: src/board.c:do_nwrite (line 467)
-
-    Initiates note composition. Character can then use:
-    - note to <recipient>
-    - note subject <text>
-    - note text (enters string editor)
-    - note send
-
-    Args:
-        char: Character executing command
-        args: Command arguments (unused)
-
-    Returns:
-        Command result message
-    """
-    from mud.commands.notes import do_note
-
-    return do_note(char, "write")
-
-
-def do_nlist(char: Character, args: str = "") -> str:
-    """List notes on current board.
-
-    ROM parity: src/board.c:do_nlist (line 648)
-
-    Args:
-        char: Character executing command
-        args: Command arguments (unused)
-
-    Returns:
-        Formatted list of notes
-    """
-    from mud.commands.notes import do_note
-
-    return do_note(char, "list")
-
-
-def do_nread(char: Character, args: str) -> str:
-    """Read a note from the board.
-
-    ROM parity: src/board.c:do_nread (line 563)
-
-    Args:
-        char: Character executing command
-        args: Note number to read or empty for next unread
-
-    Returns:
-        Note content or error message
-    """
-    from mud.commands.notes import do_note
-
-    if args.strip():
-        return do_note(char, f"read {args}")
-    else:
-        return do_note(char, "read")
-
-
-# =============================================================================
-# OLC Helper Functions Public API (src/olc_act.c)
-# =============================================================================
-
-
-def show_obj_values(obj) -> str:
-    """Display object value fields formatted for OLC.
-
-    ROM parity: src/olc_act.c:show_obj_values (line 2210)
-
-    Shows v0-v4 value fields with descriptions based on item_type.
-
-    Args:
-        obj: Object to display values for
-
-    Returns:
-        Formatted string showing object values
-    """
-    from io import StringIO
-
-    from mud.commands.build import _oedit_show
-
-    output = StringIO()
-    _oedit_show(output, obj.prototype if hasattr(obj, "prototype") else obj)
-    return output.getvalue()
-
-
-def wear_loc_lookup(token: str):
-    """Convert wear location token to WearLocation enum.
-
-    ROM parity: src/olc_act.c:wear_loc (line 1967)
-
-    Args:
-        token: Wear location name (e.g., "head", "body", "wield")
-
-    Returns:
-        WearLocation enum value or None if invalid
-    """
-    from mud.commands.build import _resolve_wear_loc
-
-    try:
-        return _resolve_wear_loc(token)
-    except (ValueError, KeyError):
-        return None
-
-
-def show_flag_cmds() -> str:
-    """Display available room flags for OLC.
-
-    ROM parity: src/olc_act.c:show_flag_cmds (line 126)
-
-    Returns:
-        Formatted string listing available room flags
-    """
-    from mud.models.constants import RoomFlag
-
-    flags = []
-    for flag in RoomFlag:
-        # Skip zero value (no flags set)
-        if flag.value != 0:
-            flags.append(f"{flag.name.lower():20} - {flag.value}")
-
-    return "Available room flags:\n" + "\n".join(flags)
-
-
-# =============================================================================
-# Misc Utility Functions Public API
-# =============================================================================
-
-
-def check_blind(char: Character) -> bool:
-    """Check if character is blind (cannot see).
-
-    ROM parity: src/act_info.c:check_blind (line 542)
-
-    Args:
-        char: Character to check
-
-    Returns:
-        True if character can see, False if blind
-    """
-    from mud.models.constants import AffectFlag
-
-    checker = getattr(char, "has_affect", None)
-    if callable(checker):
-        try:
-            return not bool(checker(AffectFlag.BLIND))
-        except Exception:
-            pass
-
-    affected = getattr(char, "affected_by", 0)
-    try:
-        return not bool(int(affected) & int(AffectFlag.BLIND))
-    except Exception:
-        return True
-
-
-def substitute_alias(char: Character, input_text: str) -> str:
-    """Expand aliases in command input.
-
-    ROM parity: src/alias.c:substitute_alias (line 41)
-
-    Args:
-        char: Character whose aliases to use
-        input_text: Command input to expand
-
-    Returns:
-        Expanded command text with aliases substituted
-    """
-    from mud.commands.dispatcher import _expand_aliases
-
-    return _expand_aliases(char, input_text)[0]
-
-
-def mult_argument(argument: str, number_str: str) -> tuple[int, str]:
-    """Parse multiplier from argument (e.g., "5.sword" -> 5, "sword").
-
-    ROM parity: src/interp.c:mult_argument (line 743)
-
-    Used for shop commands like "buy 5 bread".
-
-    Args:
-        argument: Full argument string
-        number_str: Pre-extracted number portion (unused in Python version)
-
-    Returns:
-        Tuple of (quantity, item_name)
-    """
-    from mud.commands.shop import _parse_purchase_quantity
-
-    try:
-        quantity, item = _parse_purchase_quantity(argument)
-        return (quantity, item)
-    except Exception:
-        return (1, argument)
-
-
-# =============================================================================
-# Additional OLC Helper Functions
-# =============================================================================
-
-
-def set_obj_values(obj: Object, value_num: int, value: str) -> bool:
-    """Parse and set object value by index.
-
-    ROM parity: src/olc_act.c:set_value (line 543)
-
-    Args:
-        obj: Object to modify
-        value_num: Value index (0-4)
-        value: String value to parse and set
-
-    Returns:
-        True if value was set successfully, False otherwise
-    """
-    if not (0 <= value_num <= 4):
-        return False
-
-    try:
-        obj.value[value_num] = int(value)
-        return True
-    except (ValueError, IndexError):
-        return False
-
-
-def check_range(lower: int, upper: int) -> bool:
-    """Validate numeric range.
-
-    ROM parity: src/olc.c:check_range (line 201)
-
-    Args:
-        lower: Lower bound
-        upper: Upper bound
-
-    Returns:
-        True if range is valid (lower <= upper)
-    """
-    return lower <= upper
-
-
-def wear_bit(location: str) -> int:
-    """Convert wear location name to bit flag.
-
-    ROM parity: src/olc_act.c:wear_bit (line 891)
-
-    Args:
-        location: Wear location name
-
-    Returns:
-        Wear bit flag value, or 0 if invalid
-    """
-    from mud.commands.build import _resolve_wear_loc
-
-    loc = _resolve_wear_loc(location)
-    if loc is None:
-        return 0
-
-    return 1 << int(loc)
-
-
-def show_liqlist() -> str:
-    """Display available liquid types for containers.
-
-    ROM parity: src/olc_act.c:show_liqlist (line 723)
-
-    Returns:
-        Formatted string listing liquid types
-    """
-    from mud.models.constants import LIQUID_TABLE
-
-    liquids = []
-    for idx, liq in enumerate(LIQUID_TABLE):
-        liquids.append(f"{liq.name:20} - {idx}")
-
-    return "Available liquid types:\n" + "\n".join(liquids)
-
-
-def show_damlist() -> str:
-    """Display available damage types for weapons.
-
-    ROM parity: src/olc_act.c:show_damlist (line 798)
-
-    Returns:
-        Formatted string listing damage types
-    """
-    from mud.models.constants import DamageType
-
-    damages = []
-    for dam in DamageType:
-        damages.append(f"{dam.name.lower():20} - {dam.value}")
-
-    return "Available damage types:\n" + "\n".join(damages)
-
-
-def show_skill_cmds() -> str:
-    """Format skill list for display.
-
-    ROM parity: src/olc_act.c:show_skill (line 1021)
-
-    Returns:
-        Formatted string listing all skills
-    """
-    from mud.world.world_state import skill_registry
-
-    if not skill_registry or not hasattr(skill_registry, "skills"):
-        return "Skills not loaded."
-
-    skills = list(skill_registry.skills.keys())
-
-    return "Available skills:\n" + "\n".join(f"  {skill}" for skill in sorted(skills))
-
-
-def show_spec_cmds() -> str:
-    """Format special function list for display.
-
-    ROM parity: src/olc_act.c:show_spec (line 1089)
-
-    Returns:
-        Formatted string listing available special functions
-    """
-    specs = [
-        "spec_breath_any",
-        "spec_breath_acid",
-        "spec_breath_fire",
-        "spec_breath_frost",
-        "spec_breath_gas",
-        "spec_breath_lightning",
-        "spec_cast_adept",
-        "spec_cast_cleric",
-        "spec_cast_judge",
-        "spec_cast_mage",
-        "spec_cast_undead",
-        "spec_executioner",
-        "spec_fido",
-        "spec_guard",
-        "spec_janitor",
-        "spec_mayor",
-        "spec_poison",
-        "spec_thief",
-        "spec_nasty",
-        "spec_troll_member",
-        "spec_ogre_member",
-        "spec_patrolman",
-    ]
-
-    return "Available special functions:\n" + "\n".join(f"  {spec}" for spec in sorted(specs))
-
-
-def show_version() -> str:
-    """Show OLC version information.
-
-    ROM parity: src/olc.c:show_version (line 93)
-
-    Returns:
-        OLC version string
-    """
-    return "QuickMUD OLC v1.0 - Python ROM 2.4b Port"
-
-
-def change_exit(room, direction: str, command: str, argument: str) -> str:
-    """Edit room exit in specified direction.
-
-    ROM parity: src/olc_act.c:change_exit (line 2201)
-
-    Args:
-        room: Room to modify
-        direction: Direction name (north, south, etc.)
-        command: Edit command (create, delete, to, key, name, desc)
-        argument: Command argument
-
-    Returns:
-        Status message
-    """
-    from mud.commands.build import _redit_handle_exit
-
-    return _redit_handle_exit(room, direction, command, argument)
-
-
-def show_help() -> str:
-    """Show OLC editor help.
-
-    ROM parity: src/olc_act.c:show_help (line 165)
-
-    Returns:
-        Help text for OLC commands
-    """
-    return """OLC Editor Commands:
-
-    show     - Display current object/room/mob
-    create   - Create new item
-    edit     - Edit existing item
-    delete   - Delete item
-    list     - List items
-    save     - Save changes to disk
-    done     - Exit editor
-
-    For specific editor help, use: help aedit, help redit, help oedit, help medit
-    """
-
-
-def add_reset(area, reset_type: str, args: list[int]) -> bool:
-    """Add reset command to area.
-
-    ROM parity: src/olc_act.c:add_reset (line 3412)
-
-    Args:
-        area: Area to modify
-        reset_type: Reset type ('M', 'O', 'P', 'G', 'E', 'D', 'R')
-        args: Reset arguments (vnums, limits, etc.)
-
-    Returns:
-        True if reset was added successfully
-    """
-    from mud.loaders.reset_loader import Reset
-
-    try:
-        reset = Reset(
-            command=reset_type,
-            arg1=args[0] if len(args) > 0 else 0,
-            arg2=args[1] if len(args) > 1 else 0,
-            arg3=args[2] if len(args) > 2 else 0,
-            arg4=args[3] if len(args) > 3 else 0,
-        )
-
-        if not hasattr(area, "resets"):
-            area.resets = []
-
-        area.resets.append(reset)
-        return True
-    except Exception:
-        return False
-
-
-# =============================================================================
-# Admin Utility Functions
-# =============================================================================
-
-
-def do_imotd(char: Character) -> str:
-    """Display immortal message of the day.
-
-    ROM parity: src/act_wiz.c:do_imotd (line 1021)
-
-    Args:
-        char: Character requesting IMOTD
-
-    Returns:
-        IMOTD text or error message
-    """
-    from mud.commands.help import do_help
-
-    return do_help(char, "imotd")
-
-
-def do_rules(char: Character) -> str:
-    """Display game rules.
-
-    ROM parity: src/act_comm.c:do_rules (line 892)
-
-    Args:
-        char: Character requesting rules
-
-    Returns:
-        Rules text or error message
-    """
-    from mud.commands.help import do_help
-
-    return do_help(char, "rules")
-
-
-def do_story(char: Character) -> str:
-    """Display game story/background.
-
-    ROM parity: src/act_comm.c:do_story (line 912)
-
-    Args:
-        char: Character requesting story
-
-    Returns:
-        Story text or error message
-    """
-    from mud.commands.help import do_help
-
-    return do_help(char, "story")
-
-
-def get_max_train(char: Character, stat: str) -> int:
-    """Calculate maximum stat training limit for character.
-
-    ROM parity: src/act_wiz.c:get_max_train (line 2543)
-
-    Args:
-        char: Character to check
-        stat: Stat name (str, int, wis, dex, con)
-
-    Returns:
-        Maximum trainable value for stat
-    """
-    base_max = 18
-    race_bonus = 3
-    max_possible = 25
-
-    if hasattr(char, "pcdata") and char.pcdata:
-        return min(base_max + race_bonus, max_possible)
-
-    return base_max
-
-
-def recursive_clone(obj: Object, clone_to: Object | None = None) -> Object:
-    """Deep clone object including all contents.
-
-    ROM parity: src/act_wiz.c:recursive_clone (line 2320)
-
-    Recursively clones an object and all objects contained within it.
-    This is used by OLC and clone commands to duplicate complex items.
-
-    Args:
-        obj: Object to clone
-        clone_to: Parent object to add clone to (None for standalone)
-
-    Returns:
-        Cloned object with all contents
-    """
-    from mud.models.obj import ObjIndex
-    from mud.models.object import Object, create_object
-
-    if not obj.prototype:
-        proto = ObjIndex(
-            vnum=obj.vnum,
-            name=obj.name,
-            short_descr=obj.short_descr,
-            long_descr=obj.long_descr,
-            description=obj.description,
-            item_type=obj.item_type,
-            extra_flags=obj.extra_flags,
-            wear_flags=obj.wear_flags,
-            value=obj.value.copy() if obj.value else [0, 0, 0, 0, 0],
-            weight=obj.weight,
-            cost=obj.cost,
-            level=obj.level,
-        )
-    else:
-        proto = obj.prototype
-
-    new_obj = create_object(proto)
-
-    for content in obj.contained_items:
-        recursive_clone(content, new_obj)
-
-    if clone_to:
-        clone_to.contained_items.append(new_obj)
-        new_obj.location = None
-
-    return new_obj