-
Notifications
You must be signed in to change notification settings - Fork 2
Admin Tools
The admin tools are a set of commands that can be used to manage the data pack. These use /function and /scoreboard commands, meaning only players with access to these can use them (server operators or worlds with cheats enabled).
To give yourself a turtle egg without having to craft it, use this command:
/function turtlecraft:admin/get_egg
To see a list of every loaded turtle, use this command:
/function turtlecraft:admin/turtle_list
This list includes information about each turtle, such as its name, status, owner, fuel, id, position and dimension.
Displays some general statistics, such as the total amount of turtles that have been created, how many of those are in loaded and unloaded chunks, and how many have been removed for being invalid.
To view a list of options for the data pack, you can use this command:
/function turtlecraft:admin/options
| Option | Description |
|---|---|
| Max Turtle Count | Stops turtle spawns after reaching this threshold |
| Max Actions Per Tick | Global action limit per tick - all turtles contribute to the action count |
| Max Program Length | Maximum program length, checked only when editing the program |
| Delay - Normal | Delay in ticks for turtle actions without fuel (20 ticks = 1 second) |
| Delay - Fueled | Delay in ticks for turtle actions with fuel (20 ticks = 1 second) |
| Fuel Multiplier | Conversion rate from items to fuel points (percentage) |
| Launch Strength | Projectile launch speed, affects trajectory and arrow damage |
| Paused | If enabled, turtles won't execute instructions |
| Skip Delay | If enabled, ignore action delay for if, unless, line, counter, comment
|
| Show Warnings | If enabled, show warnings in chat (for every player) |
| Limit Directions | If enabled, certain directions are hidden while editing instructions |
| Global Updates | If enabled, update loaded turtles every 5 seconds and remove invalid entities |
| Locked Turtles | If enabled, only the owner of a locked turtle can interact with it |
| Auto Refresh | If enabled, refresh the current page of the turtle menu when the player is nearby |
| Ride Turtles | If enabled, players can ride turtles while they move |
| Use Tools | If enabled, turtles can equip and use tools |
| Use Discs | If enabled, music discs can be used to store programs |
| Use Fuel | If enabled, turtles can consume certain items to get fuel |
| Change Appearance | If enabled, certain blocks can be used to change a turtle's appearance |
| Limit Counter Display | If enabled, the number of counters in their page is limited to fit the window |
To edit these options, simply click them in chat. To insert custom values, type your value at the end of the command:
/scoreboard players set max_turtle_count turtlecraft.options 10
This command quickly enables/disables the Paused data pack option. If you want to quickly stop all turtles, you can use this command:
/function turtlecraft:admin/toggle
Note that this doesn't actually stop their program, so that they can continue what they were doing when this command is used again.
To force an update of every loaded turtle, use this command:
/function turtlecraft:admin/global_update
Turtles update automatically every time they move, run an instruction, or are interacted with. However, idle turtles don't update automatically in order to improve performance.
This can be useful when the entities that make up a turtle become de-synchronized, which may occur if they move in unexpected ways (such as a player using the /tp command on them). This also detects invalid turtles (missing entities, invalid ID, etc.) and removes them.
Players with the tag turtlecraft.bypass_locks can interact with turtles even if they are locked.
You can use this command to quickly enable/disable this tag for yourself:
/function turtlecraft:admin/bypass_locks
If you upgraded from the previous data pack version, you need to use this function to update turtles and selected items so that they work again.
/function turtlecraft:admin/upgrade
To uninstall the data pack, use this command:
/function turtlecraft:admin/uninstall
This removes everything related to the data pack, including turtles in loaded chunks (dropping all the items).
Turtles in unloaded chunks can't be removed, but you can use /kill @e[tag=turtlecraft.turtle] to remove them once they are loaded again. This will drop their items, but the equipped tool will have a hidden tag that will make the item invalid if the data pack is installed again.
If the data pack isn't removed from the world files, reloading the world will reinstall it.