Skip to content

Latest commit

 

History

History
72 lines (49 loc) · 3.94 KB

README.md

File metadata and controls

72 lines (49 loc) · 3.94 KB
Raw

minecraft-datapacks

Assorted vanilla Minecraft datapacks.

Coordinates and waypoints

The datapacks are:

  • coords.zip - shows player coordinates in the action bar.
  • waypoints.zip - manages 62 player-set waypoints plus automatically updated bed and death location waypoints.
  • help.zip - provides a function that implements a basic help command by calling help functions from the other datapacks.
  • fatigue.zip - warns the player when lack of sleep would spawn phantoms.
  • cartokill.zip - kills cartographers near the player when they trade with villagers, in order to prevent a server crash when a cartographer unlocks its explorer map trade; this only applies on pre-release servers with a map generated before pre6 (I think).
  • recipes.zip - adds smelting recipes to create smooth blocks, like in the 1.14 snapshots: stone smelts to smooth_stone, quartz smelts to smooth_quartz, sandstone smelts to smooth_sandstone and red_sandstone smelts to smooth_red_sandstone.

Installation

For all datapacks, download the zip file from the releases page and place it in the world/datapacks/ folder under the server directory. The packs are all independent of each other, but it makes no sense to install the help pack without coords.zip or waypoints.zip.

In addition, to use custom commands beginning with !, you will need to configure the server wrapper (e.g. mark2) according to the instructions in the Mark2 Configuration section below.

Custom Commands

Custom commands are supported using the mark2 server wrapper's trigger feature. Currently, without mark2 or some equivalent server wrapper to handle triggers in chat, players cannot use the custom commands described below.

  • help.zip datapack:
    • !help - Show custom command help.
  • coords.zip datapack:
    • !coords - Turn off/on coordinate display.
  • waypoints.zip datapack:
    • !bed - Get your bed coordinates.
    • !death - Get your latest death coordinates.
    • !setwpX - Store waypoint X as your current location. X can be 0..9, a..z or A..Z (62 waypoints). Examples: !setwp9, !setwpz, !setwpZ
    • !delwpX - Delete waypoint X. X as per !setwpX.
    • !wpX - Get the coordinates of waypoint X. "Dim" (dimension) in the output is: -1 = nether, 0 = overworld, +1 = end. Examples: !wp1 = get !setwp1 and !wpa = get !setwpa
    • !listwps - List all of your waypoints.

Mark2 Configuration

To use triggers.txt to run custom commands, add the following to mark2.properties in the directory containing the server JAR:

plugin.trigger.enabled=true
plugin.trigger.path=triggers.txt
plugin.trigger.command=execute as {user} run {message}

The start of triggers.txt should read as follows:

!help,function io.totemo.help:help-command

!coords,function io.totemo.coords:coords-command
!bed,function io.totemo.waypoints:bed-command
!death,function io.totemo.waypoints:death-command
!listwps,function io.totemo.waypoints:listwps-command

!delwp0,function io.totemo.waypoints:delwp0-command
!setwp0,function io.totemo.waypoints:setwp0-command
!wp0,function io.totemo.waypoints:wp0-command

# ... !delwp, !setwp and !wp entries for 61 more waypoints ...

The mark2/gentriggers.sh script generates a triggers.new file that can be appended to triggers.txt to supply all of the custom commands for waypoints 0..9, a..z and A..Z.

Building

Each of the datapacks has a build.sh (Linux) shell script that generates the ZIP file of the datapack. Simply run that.

The waypoints datapack uses waypoints/generate.sh to generate functions for each of the 62 player-set waypoints; waypoints/build.sh runs it automatically.