DOCSEARCHbyAlgolia
Submit Docs

Waystones Minecraft Mod

repository·26.2·Indexed 19 days ago

https://github.com/twelveiterations/waystones

A Minecraft mod providing a teleportation system using activated waystones for Survival, Adventure, and Server environments. Includes a comprehensive CLI for administrators to place waystones, manage player activations, reset cooldowns, and inspect player waystone lists and GUIs.

Tokens
1.1K
Snippets
3
Records
7
Agent score
15%

What's inside Waystones

  2. Reset waystone cooldowns

    26.2

    If a player is unable to use waystones due to cooldowns, administrators can reset them using the cooldown reset subcommand.

    • Reset all cooldowns for players: /waystones cooldown <targets> reset all

    • Reset a specific cooldown identifier: /waystones cooldown <targets> reset <identifier> Note: The <identifier> is a Minecraft Identifier (e.g., namespace:path).

  3. Manage player waystone activation and forgetting

    26.2

    Administrators can manually control which waystones players have access to using activate and forget.

    • To activate a waystone at a location: /waystones activate <players> <x y z>

    • To deactivate a specific waystone at a location: /waystones forget <players> <x y z>

    • To wipe all waystones from a player: /waystones forget <players> all

  4. Place a new waystone via CLI

    26.2

    Use the place subcommand to spawn a waystone at a specific coordinate. You must provide a position, a waystone type (style), and a name.

    Arguments:

    • pos: The block position (BlockPos).
    • type: The identifier for the waystone style (e.g., waystones:style_name). If no namespace is provided, it defaults to waystones.
    • name: A greedy string representing the custom name for the waystone.
    # Example: Place a waystone at 100 64 100 of type 'default' named 'Home'
/waystones place 100 64 100 default Home

  5. Waystones CLI Commands Reference

    26.2

    The /waystones command provides administrative and player-related management tools. Most commands require specific permissions (typically GAMEMASTER level via Balm).

    Command Summary

    CommandDescription
    /waystones activate <targets> <pos>Activates a waystone at the specified position for the target players.
    /waystones forget <targets> <pos>Deactivates a waystone at the specified position for the target players.
    /waystones forget <targets> allDeactivates all waystones currently held by the target players.
    /waystones place <pos> <type> <name>Places a new waystone of a specific type at the given position with a custom name.
    /waystones count <player>Returns the number of waystones a player has.
    /waystones list <player>Lists waystones for a player. Use all to see all waystones, not just owned ones.
    /waystones gui <player>Opens the Waystones GUI for the specified player.
    /waystones twinbound <first> <second>Links two players using Twinbound Feathers.
    /waystones cooldown <targets> reset [all | <identifier>]Resets waystone cooldowns for target players.

  6. Open the player's waystones GUI via command

    26.2

    The OpenPlayerWaystonesGuiCommand allows an operator to open a specialized administrative waystone selection menu for a specific player. This menu is configured with TeleportFlags.ADMIN permissions and uses an admin-specific sorting comparator to inspect the target player's waystones. This is typically used for administrative inspection of a player's activated and decorated waystones.

    # Note: The exact command string is determined by the registration logic in the mod's command registration system, but it accepts a player selector.
# Usage pattern:
<command_root> <player_selector>

# Example (assuming the command root is 'waystones'):
/waystones <player_name>

  7. Use the /waystones count command

    26.2

    The /waystones count command allows a user to check the total number of activated waystones for a specific player, as well as how many of those waystones are owned by that player.

    Usage: /waystones count <player>

    Arguments:

    • <player>: An entity selector (e.g., a player name) used to identify the target player whose waystones will be counted.

    Output: Returns a success message containing:

    • The player's name.
    • The total number of activated waystones associated with that player.
    • The number of waystones owned by that player.
    /waystones count <player>