路标
适用于 Minecraft (Paper) 的路标插件
游戏内命令
-
/wsave <waypoint-name> | 保存一个新路标(需要权限:zoink.waypoints)。
-
/wtp <waypoint-name> | 传送至某一路标(需要权限:zoink.waypoints)。
-
/wlist <world-name> | 显示所有路标的列表(需要权限:zoink.waypoints)。
-
/wdelete <waypoint-name> | 删除某一路标(需要权限:zoink.waypoints)。
-
/whome | 将玩家传送回其出生点(需要权限:zoink.waypoints)。
-
/wspawn | 将玩家传送至 config.yml 中定义的出生点(需要权限:zoink.waypoints)。
-
/wconfig <config-var(s)> | 用于检查或重新定义 config.yml 中的变量(需要权限:zoink.waypoints,服务器管理员)
-
/wsetup <optional-config-var(s)> | 如有需要,用于设置 config.yml,参数为可选(需要权限:zoink.waypoints,服务器管理员)
权限:
- zoink.waypoints:允许用户使用个人快捷点。
- zoink.waypoints.admin:允许管理员通过
wconfig 或 wsetup 配置/设置插件。
config.yml
给懒人准备的
- 如果你是服务器运营者,可以直接运行
/wsetup 来自动设置 config.yml。
- 注意:这并不能保证 100% 成功。
- 如果你想进行设置但修改某个变量(例如将
limited_waypoints 设为 true),你可以这样做:
# 单个参数
/wsetup limited_waypoints=true
# 多个参数
/wsetup limited_waypoints=true max_waypoints=20
'wconfig' 命令
- 该命令的参数用法与
/wsetup 完全相同,但它仅更改你定义的变量。
- 另一个功能是检查变量的当前值,如下所示:
/wconfig limited_waypoints
# 输出:
# WP> limited_waypoints: false
# 数组参数示例;注意此处无空格
/wconfig allowed_worlds_colors=[light_purple,green,gold]
定义出生点
- 如果你不想在世界中设置出生点,只需在
config.yml 的 spawn 键下将 enabled 设置为 false 即可。
- 只需将 x、y 和 z 坐标更改为出生点的任意位置。
- 如果你的出生点位于默认主世界之外的其他世界中,或者你的主世界文件夹名称不同,只需更改
spawn.world 下的名称即可。
布尔值
use_real_world_names 指的是当用户列出他们在特定世界中的传送点时是否使用真实世界名称。
- 当此设置设置为
true 时,会使用世界文件夹的名称,例如 world_nether。
- 为了获得更美观的结果,我建议将其保持为 false。
multi_world_teleport 当设置为 true 时,允许玩家传送到与他们当前所在世界不同的世界中的传送点。
- 例如,玩家可以在主世界中传送到他们位于末地中的传送点。
limited_waypoints 适用于希望限制玩家可保存的传送点数量的服务器管理员。
- 注意,如果玩家已经拥有超过你定义的最大传送点数量,则不会移除任何传送点。
- 此布尔值与
max_waypoints 变量结合使用,该变量定义了玩家可保存的最大传送点数量。
teleport_time_limits.enabled 当设置为 true 时,启用延迟传送和命令冷却时间。
- 默认设置是等待 5 秒不移动以进行传送,命令之间的冷却时间为 10 秒。
允许的世界
- 你可以设置玩家能够在哪些世界中保存传送点。
- 世界的顺序即为玩家在运行
/wlist 时显示的顺序。
允许的世界颜色
自定义世界名称
- 仅当你将
use_real_world_names 设置为 false 时,此项才生效。
- 它们的顺序与
allowed_worlds 列表中的顺序相同。
构建插件
要构建插件,请运行以下命令:
cd Waypoints
mvn clean package
Waypoints
Waypoints Plugin for Minecraft (Paper)
In-game commands
- /wsave <waypoint-name> | saves a new waypoint (permission required: zoink.waypoints).
- /wtp <waypoint-name> | teleports to a waypoint (permission required: zoink.waypoints).
- /wlist <world-name> | shows the of list all waypoints (permission required: zoink.waypoints).
- /wdelete <waypoint-name> | delete a waypoint (permission required: zoink.waypoints).
- /whome | teleports player to their spawnpoint (permission required: zoink.waypoints).
- /wspawn | teleports player to spawn defined in config.yml (permission required: zoink.waypoints).
- /wconfig <config-var(s)> | used to check or redefine variables in config.yml (permission required: zoink.waypoints, server operator)
- /wsetup <optional-config-var(s)> | used to setup config.yml if needed, arguments are optional (permission required: zoink.waypoints, server operator)
Permissions:
- zoink.waypoints: Allow the user to use the personal waypoints.
- zoink.waypoints.admin: Allow admins to configure/setup plugin through
wconfig or wsetup
Config.yml
For Lazy People
- You can simply run
/wsetup if you are a server operator to automatically setup config.yml
- Note this is not guaranteed to 100% work
- If you want to set up but change a variable like
limited_waypoints to true, you can simply do the following:
# One argument
/wsetup limited_waypoints=true
# Multiple Arguments
/wsetup limited_waypoints=true max_waypoints=20
The 'wconfig' Command
- Arguments work the exact same as the
/wsetup command, but just changes the variables you define
- But another feature is checking the current value of a variable like this:
/wconfig limited_waypoints
# Output:
# WP> limited_waypoints: false
# Argument Example with array; NOTICE THERE ARE NO SPACES
/wconfig allowed_worlds_colors=[light_purple,green,gold]
Defining Spawn
- If you do not want a spawn in the world you can simply set
enabled to false under the spawn key in config.yml
- Simply change the x, y, and z coordinates to wherever spawn is.
- If your spawn is in a different world than the default overworld, or your overworld folder name is different, you can simply change the name under
spawn.world.
Booleans
use_real_world_names refers to when users can list waypoints they have in a specific world.
- This setting when set to
true uses the names of the worlds folder so like world_nether.
- For a prettier looking result I would just keep this at false.
multi_world_teleport when set to true allows players to teleport to waypoints that are in a different world than the current one they are in.
- For example a player can teleport they have in The End while they are in the Overworld.
limited_waypoints is for server owners who want to limit the amount of waypoints that can be saved by a player
- Note, if a player already has more than your defined max waypoints, it will not remove any.
- This boolean combos with the
max_waypoints variable, which defines the max waypoints a player can save.
teleport_time_limits.enabled when set to true enables delayed teleports and cooldowns on commands.
- The default settings are 5 seconds to wait without moving to teleport, and 10 second cooldowns between commands.
Allowed Worlds
- You are able to set which worlds players are able to save waypoints in
- The order of the worlds is the order they will be printed out in when a player runs
/wlist.
Allowed Worlds Colors
- The colors are based on the MiniMessage Colors
- The order of the colors is the same as the ones in the
allowed_worlds list.
Custom World Names
- This only matters when you have
use_real_world_names set to false.
- They are in the same order as the
allowed_worlds list.
Build the plugin
To build the plugin, type the following commands:
cd Waypoints
mvn clean package
评论 0
登录后参与评分
还没有评论,来抢沙发吧