HeadDatabase 插件
HeadDatabase(头颅数据库)提供了大量定制的装饰头颅,允许玩家通过 GUI 浏览并获取各种头颅(包括玩家头和自定义纹理头)。主要指令如下:
-
/hdb
或/heads
,/headdb
– 打开头颅数据库界面。- 作用: 打开一个GUI,让玩家浏览所有分类的头颅。一旦找到喜欢的头,点击即可购买或领取(视服务器经济/权限配置而定)。
- 参数: 无。
- 示例: 玩家输入
/hdb
,屏幕显示HeadDatabase主界面,包含搜索功能、分类目录(如动物、食物、字母等分类),玩家可以点选查看具体头颅。 - 返回信息: 无聊天输出,直接弹出Heads GUI界面。
- 权限: 所有玩家通常可使用。需要
headdb.open
或类似权限(插件安装后一般默认允许打开主界面)。
-
/hdb search <关键词>
或/hdb s <关键词>
– 搜索头颅。- 作用: 在数据库中搜索名称或描述匹配关键词的头颅条目,然后以GUI方式显示结果。
- 参数:
<关键词>
关键字,可以是头颅名称的一部分、主题等。不区分大小写。 - 示例:
/hdb search dragon
在数据库中搜索包含“dragon”(龙)的头颅,如龙头图案、末影龙等,并弹出一个仅包含匹配结果的GUI列表。 - 返回信息: 如果不在GUI内执行,会在聊天提示“找到X个匹配的头颅”,并自动打开结果界面。若未找到则提示无匹配结果。
- 权限:
headdb.search
(默认所有玩家可以搜索)。
-
/hdb give <头颅ID> <数量> [玩家]
或/hdb g <头颅ID> [数量] [玩家]
– 给予头颅。- 作用: 管理员命令,将指定ID的头颅物品给予某玩家(或自己),可指定数量。头颅ID可以从数据库GUI中获取,每个头颅有唯一ID号。
- 参数:
<头颅ID>
要获取的头颅编号;<数量>
数量,不填则默认为1;[玩家]
目标玩家,不填则默认为执行者自己。 - 示例:
/hdb give 235 2 Alex
将ID为235的头颅物品给玩家Alex 2个。 - 返回信息: 如果ID有效,则提示“已给予玩家X某某头颅x2”;如果ID无效或玩家不在线,则提示错误。
- 权限:
headdatabase.give
(一般仅OP/管理员具有)。
-
/hdb base64 <头颅ID>
– 获取头颅纹理值。- 作用: 输出对应头颅的Base64纹理值,供高级用法(如通过命令方块
/give
获取带该纹理的头颅,或插件开发)。 - 参数:
<头颅ID>
要查询的头颅ID。 - 示例:
/hdb base64 4356
将在聊天栏显示ID 4356 头颅的纹理值字符串(一段很长的Base64编码文本)。可复制用于其他用途。 - 返回信息: 该头颅的纹理值Value字段。如果控制台执行,会输出到控制台。
- 权限:
headdatabase.admin
(通常仅管理员可用)。
- 作用: 输出对应头颅的Base64纹理值,供高级用法(如通过命令方块
-
/hdb open [玩家] <分类/search>
– 为他人打开GUI。- 作用: 管理员可以代替某玩家打开HeadDatabase界面。常用于服务器通过交互触发,如点击NPC打开GUI。
- 参数:
[玩家]
可选,要为其打开界面的玩家名。不填则默认自己;<分类/search>
可选,直接打开特定分类或搜索结果界面。例如category:alphabet
或search:<关键字>
。 - 示例:
/hdb open Alex category:food
将为玩家Alex打开“食物”分类的头颅界面。 - 返回信息: 如果成功,目标玩家会看到相应界面。命令执行者无特别反馈。
- 权限:
headdatabase.open.other
(允许打开他人GUI)。
-
/hdb random [玩家] [分类]
– 随机赠送一个头颅。- 作用: 从数据库中随机挑选一个头颅给予指定玩家。可指定限定分类。
- 参数:
[玩家]
目标玩家,默认为自己;[分类]
限定分类名称,可选。 - 示例:
/hdb random Steve
将随机选一个头颅给Steve。/hdb random Alex animals
只从“动物”分类随机给Alex一个头颅。 - 返回信息: 通知玩家获取了什么头颅(通常头颅物品直接进背包,并会有获取物品提示)。
- 权限:
headdatabase.admin
或专门的headdatabase.random
(视插件实现,一般仅管理员用)。
-
/hdb reload
– 重载插件。- 作用: 重载HeadDatabase的配置和数据。通常用于更新本地数据缓存,以获取开发者发布的新头颅列表或应用配置更改。
- 参数: 无。
- 示例: 管理员执行
/hdb reload
重新从互联网获取最新头颅数据库(如果配置了自动更新)并加载配置文件的改动。 - 返回信息: 控制台会输出重载结果,例如“HeadDatabase data reloaded”,玩家执行则在聊天提示重载成功或失败原因(如API连接问题)。
- 权限:
headdatabase.admin
。
权限与经济: HeadDatabase 通常结合经济插件使用。玩家需要一定货币才能购买头颅:每个头颅在数据库有预设价格,玩家点击获取时,插件会检测其余额并扣费。如果没有Vault经济,则可设定为免费获取或者使用积分。相关权限:
headdb.use
/headdb.open
– 允许使用HeadDatabase。headdb.free
– 允许玩家免费获取头颅而不扣费。headdb.search
– 允许使用搜索功能。headdb.favorite
– 允许收藏头颅(插件支持玩家收藏常用头颅)。- 管理权限
headdatabase.admin
– 默认给予OP,包括给予头颅、重载等特权。
玩家通过HeadDatabase可以获取丰富的定制头颅用于装饰,例如食物模型、字母方块、像素艺术等。插件支持关键字搜索和分类浏览,使寻找需要的头颅非常方便。管理员也可将常用头颅的ID制作按钮或命令供玩家快捷获取。
ItemsAdder 插件
ItemsAdder 是一个功能强大的自定义物品/方块插件,可以添加新的材质、物品、方块、音效、HUD等内容。它提供大量管理指令来操作自定义内容、资源包和玩家动画等。主要指令如下:
-
/ia
或/itemsadder
– 打开物品列表GUI。- 作用: 为有权限的玩家打开ItemsAdder提供的物品列表界面,浏览服务器自定义添加的所有物品/方块,并可点击获得(一般仅管理员或创意模式可用)。
- 参数: 可选
<分类>
– 直接打开指定分类的物品列表;可选[玩家]
– 为他人打开界面。 - 示例: 管理员输入
/ia
会看到一个GUI,按分类列出所有自定义内容,可点击获得物品。/ia Blocks
可直接打开“方块”分类列表。 - 返回信息: 无聊天输出,直接显示GUI。
- 权限: 普通玩家默认无权使用此命令。
ia.admin
权限组中的ia.admin.interactive
允许使用物品GUI。ia.user.gui
可能允许有限浏览(视配置)。
-
/iaget <物品> [数量]
– 获取自定义物品。- 作用: 直接给予执行者指定的ItemsAdder物品。物品名通常以命名空间形式
<pack>:<item>
,或插件注册的内部ID。 - 参数:
<物品>
ItemsAdder物品的命名空间ID(例如itemsadder:magic_sword
);[数量]
数量,默认为1。 - 示例:
/iaget itemsadder:tomato 16
会在玩家背包放入16个自定义物品“番茄”。 - 返回信息: 通常在聊天提示“已获取 <物品名> x16”。
- 权限:
ia.admin.iagive
(管理员),一般玩家无权直接获取。
- 作用: 直接给予执行者指定的ItemsAdder物品。物品名通常以命名空间形式
-
/iagive <玩家> <物品> [数量] [silent]
– 给予玩家自定义物品。- 作用: 将指定自定义物品发送到目标玩家背包。可选
silent
参数表示静默模式(不给目标显示获得消息)。 - 参数:
<玩家>
目标玩家;<物品>
物品命名空间ID;[数量]
数量;[silent]
字面“silent”可选,表示静默给予。 - 示例:
/iagive Alex itemsadder:magic_sword 1 silent
静默给予Alex一把Magic Sword,Alex将直接收到物品但不显示获得提示。 - 返回信息: 执行者收到确认消息,如“已给予 Alex 物品 Magic Sword x1”。
- 权限:
ia.admin.iagive
。
- 作用: 将指定自定义物品发送到目标玩家背包。可选
-
/iadrop <物品> [数量]
– 在地上生成自定义物品掉落。- 作用: 在执行者当前位置掉落指定数量的自定义物品。
- 参数:
<物品>
自定义物品ID;[数量]
数量。 - 示例:
/iadrop itemsadder:coin 10
在脚下掉落10个自定义金币物品实体。 - 返回信息: 无直接消息,物品实体会出现于地面。
- 权限:
ia.admin.iagive
(管理)。
-
/iaremove <物品> [数量] [silent]
– 从玩家背包移除物品。- 作用: 将当前玩家背包中的指定自定义物品移除一定数量。可用于管理员清除玩家身上的违规自定义物品。
- 参数:
<物品>
物品ID;[数量]
移除数量,不填则默认1;[silent]
可选,不提示玩家。 - 示例:
/iaremove itemsadder:magic_sword 1
从自己背包移除一把魔法剑。 - 返回信息: 若物品存在并移除则提示移除了X件物品;若背包无该物品则提示未找到。
- 权限:
ia.admin.iagive
(管理)。
-
/iatag
– 显示物品调试信息。- 作用: 输出当前手持物品的 ItemsAdder 调试信息,如命名空间ID、NBT数据等,用于排查问题。
- 参数: 无。
- 示例: 手持一把自定义剑执行
/iatag
,控制台和聊天会输出此物品的内部标识(namespace)、特殊标签等信息。 - 返回信息: 诸如“NamespacedID: itemsadder:magic_sword, CustomModelData: 12345, Unbreakable: false”等。
- 权限:
ia.admin
(默认管理员)。
-
/iacustommodeldata
– 显示物品的CustomModelData。- 作用: 输出当前手持物品的模型数据值,用于资源包美工人员调试。
- 参数: 无。
- 示例: 手持ItemsAdder物品执行
/iacustommodeldata
,会提示如“CustomModelData: 7000012”。 - 返回信息: 物品所持的CustomModelData数值。
- 权限:
ia.admin
.
-
/iaplayerstat <read|write|increment|decrement> <玩家> <属性> [值] [silent]
– 自定义玩家属性操作。- 作用: ItemsAdder允许定义自定义玩家属性(如角色Mana值等)。此命令可读取或修改玩家的自定义属性。
- 参数:
<read|write|increment|decrement>
操作类型:读取、写入绝对值、增加、减少;<玩家>
目标玩家;<属性>
属性名称(在ItemsAdder配置的player_stats.yml里定义);[值]
对于write是要设置的新值,对于增减是数量;[silent]
可选,不触发HUD更新等视觉提示。 - 示例:
/iaplayerstat read Alex mana
读取玩家Alex的mana值;/iaplayerstat write Alex mana 100
将Alex的mana设置为100;/iaplayerstat increment Alex mana 10
给Alex的mana加10;/iaplayerstat decrement Alex mana 5 silent
减少Alex的mana 5且静默(不在其屏幕显示变化)。
- 返回信息: 读取操作会在执行者聊天输出属性当前值,如“Alex's mana = 85”。写入/增减成功一般无明显提示,或仅控制台记录。
- 权限:
ia.admin.iaplayerstat
(管理员)。
-
/iarepair
– 修复手持物品。- 作用: 将当前手持的自定义物品耐久修满(类似/repair,但用于ItemsAdder物品亦适用)。
- 参数: 无。
- 示例: 武器即将损坏时执行
/iarepair
,耐久度恢复最大。 - 返回信息: 若成功则提示物品已修复满耐久。
- 权限:
ia.user.repair
(配置允许则玩家可用,否则仅管理员)。
-
/iarename <新名称>
– 重命名手持物品。- 作用: 更改当前持有物品的显示名称。支持使用ItemsAdder字体(表情符号、图片)和颜色代码。
- 参数:
<新名称>
想设置的名称(可包含空格和颜色符号&)。 - 示例:
/iarename &6强化剑
将手中物品重命名为金色的“强化剑”。支持ItemsAdder的特效文字。 - 返回信息: 提示物品名称已更改。如果格式有误(太长等)会有错误提示。
- 权限:
ia.user.rename
(若允许玩家自定义物品名则需赋予,通常默认OP有)。
-
/iadurability
– 修改手持物品耐久。- 作用: 打开一个界面或通过命令修改当前物品的剩余耐久值。可用于测试或调整物品耐久。
- 参数: 无 或根据版本可能需要具体值。新版通常用GUI交互。
- 示例:
/iadurability
可能弹出一个输入框或提示输入耐久值,将当前物品耐久设为指定值。 - 返回信息: 修改成功会提示耐久已更新。
- 权限:
ia.admin
或专门的ia.user.durability
。
-
/iareload
– 重载 ItemsAdder 配置。- 作用: 重新加载所有ItemsAdder配置、YML文件定义以及资源pack设置。不重新生成资源包文件。
- 参数: 无。
- 示例: 修改了items_packs内某物品属性后,执行
/iareload
以应用修改(玩家需重新下载资源包才会体现)。 - 返回信息: 控制台输出各部分重新加载成功或失败的信息,玩家执行则简单提示配置已重载。
- 权限:
ia.admin
。
-
/iazip
– 生成资源包。- 作用: 强制重新构建ItemsAdder的资源包文件,并执行
/iareload
。生成的pack.zip会打包所有自定义材质、模型以供玩家下载更新。 - 参数: 无。
- 示例:
/iazip
在服务器plugins/ItemsAdder目录重新生成资源包(pack.zip)文件,并重载插件内容。 - 返回信息: 控制台会记录打包进度,完成后提示资源包已生成。游戏内执行者会收到完成提示,可能还包括错误告警(如模型文件缺失)。
- 权限:
ia.admin
。
- 作用: 强制重新构建ItemsAdder的资源包文件,并执行
-
/iatexture [all|player]
– 强制客户端重载资源包。- 作用: 指令触发客户端重新加载资源包内容。
/iatexture all
让所有在线玩家重新载入pack,/iatexture <玩家>
单独让某玩家重载。常用于在动态更改pack后刷新玩家端显示。 - 参数: 可选
all
或目标玩家名。不指定则默认为自己。 - 示例:
/iatexture all
会强制所有玩家重新加载ItemsAdder资源包,就像重新登录一样刷新贴图。 - 返回信息: 执行成功后,玩家会看到资源包重新加载完成提示。命令本身无特殊聊天输出。
- 权限:
ia.user.iatexture
(默认玩家可用)和ia.user.iatexture.all
(允许对全体执行)。
- 作用: 指令触发客户端重新加载资源包内容。
-
/iacleancache
– 清理未使用ID缓存。- 作用: 清除ItemsAdder内部缓存中未使用的物品/方块ID,以便释放这些数值供将来新内容使用。通常在删除了一些自定义内容后执行,让之前占用的ID腾出。
- 参数: 无。
- 示例:
/iacleancache
清理完毕会提示清除了多少个未使用ID。之后推荐/iazip
重新生成资源包以彻底移除残留数据。 - 返回信息: 提示例如“Removed 5 unused item IDs from cache”。
- 权限:
ia.admin.iacleancache
。
-
/iasha1
– 计算资源包哈希。- 作用: 计算当前已加载资源包的SHA1哈希值,方便将该值配置到server.properties的resource-pack-sha1校验。
- 参数: 无。
- 示例:
/iasha1
返回当前pack.zip文件的SHA1,例如“Pack SHA1: 9f2a3b...”。 - 返回信息: 直接在聊天输出哈希字符串。
- 权限:
ia.user.iasha1
(默认所有人可用,便于玩家验证资源包完整性)。
-
/iahitbox
– 显示放置家具的边界。- 作用: 对使用ItemsAdder放置的家具类方块,显示其占用的碰撞箱范围,以调试放置问题。
- 参数: 无。
- 示例: 管理员面对一个自定义椅子执行
/iahitbox
,将临时以线框显示该椅子的占用空间范围。 - 返回信息: 切换在客户端渲染一个彩色方框轮廓。再次执行关闭显示。
- 权限:
ia.admin.iahitbox
。
-
/iaplaysound <音效ID> <玩家>
– 播放自定义音效。- 作用: 立即对指定玩家播放ItemsAdder添加的自定义声音。可用于在控制台或指令方块触发特殊声音。
- 参数:
<音效ID>
自定义音效的namespaced ID;<玩家>
目标玩家名,可以是@a
对所有玩家(需支持)。 - 示例:
/iaplaysound itemsadder:lion_roar Alex
在Alex客户端播放“狮子吼叫”声音。 - 返回信息: 无直接消息,目标玩家会听到对应声音。
- 权限:
ia.admin.iaplaysound
(管理员)。
-
/iaplaytotemanimation <动画名> <玩家>
– 触发不死图腾动画。- 作用: 让指定玩家播放一次不死图腾的动画效果(绿色照耀护盾的效果),可用于自定义复活或Buff展示。
- 参数:
<动画名>
动画名称(在ItemsAdder配置的totem_animations文件中定义);<玩家>
目标玩家。 - 示例:
/iaplaytotemanimation default Steve
让Steve播放默认的不死图腾动画。 - 返回信息: 无文本输出,目标玩家屏幕出现图腾特效动画。
- 权限:
ia.admin.iatotemanimation
。
-
/iaentity
– 自定义实体管理菜单。- 作用: 打开一个管理界面,用于管理ItemsAdder添加的自定义实体(如可驯服宠物、自定义生物)。可以生成、删除自定义实体等。
- 参数: 无。
- 示例:
/iaentity
管理员执行后弹出GUI,里面列出可以生成的自定义实体类型,点击相应按钮生成实体,或管理现有实体。 - 返回信息: 无直接消息,打开实体管理界面。
- 权限:
ia.admin.iaentity
。
-
/ia config
– 打开配置GUI。- 作用: ItemsAdder在新版本可能提供了图形化配置界面,此命令打开配置菜单,允许在线调整部分设置。
- 参数: 无。
- 权限:
ia.admin.iaconfig
。
权限说明: ItemsAdder 权限以ia.
开头,大体分为admin和user两类。ia.admin
下含多个子权限,如上文中给予自定义内容的命令基本需要ia.admin.iagive
等。玩家方面,一般只有ia.user.*
的一些权限可给,例如允许玩家使用特定表情、特效或GUI。默认情况下,大多数ItemsAdder指令限管理员使用,普通玩家通过触发机制(例如制作配方、右键打开特定GUI物品)来体验插件内容,而无需输入指令。
LoneLibs 插件
LoneLibs 是由开发者 LoneDev 提供的一系列库文件集合,供其旗下插件(如ItemsAdder、ImageMaps等)使用。LoneLibs 本身没有面向玩家或管理员的可用指令,它在后台为其他插件提供支持。安装LoneLibs后,服务器会在启动时加载其中的库类以供依赖的插件调用。
- LoneLibs 没有玩家指令或管理指令需要整理。只需将其安装在
plugins
目录即可,其配置极少且通常无须修改。 - 权限: LoneLibs 不涉及权限控制,因为没有交互指令。
说明: 请确保LoneLibs保持最新版本以满足其依赖插件的要求。如ItemsAdder在最新版本要求LoneLibs 1.x.x版本,则需要对应更新,否则相关插件可能无法正常运行。LoneLibs 有自动更新机制,在依赖插件启动时若检测缺少库可能会自行下载更新文件。总之,对服务器管理员而言,管理LoneLibs仅需关注版本兼容,无需执行特殊命令。
mcMMO 插件
mcMMO 是经典的RPG技能系统插件,为生存服务器加入技能练级、能力奖励等元素。玩家通过挖矿、伐木、战斗等提升技能等级,获得特殊技能(如采集双倍掉落、冲刺技能等)。mcMMO 主要指令包括技能查询、排行榜、派对和管理员维护等:
-
/mcstats
– 查看自己所有技能等级。- 作用: 列出玩家当前各项mcMMO技能的等级和经验进度。常用来总览自己的成长。
- 参数: 无。
- 示例: 玩家输入
/mcstats
,聊天窗口将显示例如:
其中Power Level是所有技能等级总和。Mining: 125 (50% towards 126) Woodcutting: 89 (30% towards 90) Swords: 45 ... ... Power Level: 400
- 权限: 所有玩家可用。
-
/mctop [技能]
– 查看技能排行榜。- 作用: 显示全服mcMMO技能等级最高的玩家排名。如果指定技能则仅该技能的排名,不指定则按Power Level总等级排行。
- 参数:
[技能]
可选技能名称,如mining, swords等。不填则默认为Power等级排行。 - 示例:
/mctop mining
列出挖矿技能最高的若干玩家及等级,/mctop
则列出综合等级最高玩家。 - 返回信息: 如“Mining Top 10: 1. Steve - 250, 2. Alex - 200, ...”。支持分页
/mctop <技能> 2
查看后续名次。 - 权限: 所有玩家可用。
-
/mcability
或/mcabil
,/ability
– 主动技能开关。- 作用: 切换技能能力激活开关。当打开时,使用对应触发键(通常空手右键或Shift+右键)可激活技能;关闭则禁用手动激活,方便不想误触技能的玩家。
- 参数: 无。
- 示例:
/mcability
执行后,会提示“Ability activate: OFF”。之后即使快速右键锄地也不会触发“超级收割”技能。再次执行重新启用技能激活。 - 返回信息: 提示已开启或关闭主动技能激活。
- 权限: 所有玩家可用。
-
/inspect [玩家]
– 查看他人技能等级。- 作用: 查看另一玩家的技能等级总览。默认需要权限。
- 参数:
[玩家]
目标玩家名。不填则查看自己,相当于/mcstats
。 - 示例:
/inspect Alex
将显示Alex的各技能等级和Power Level。 - 返回信息: 类似于
/mcstats
的输出,但标题会注明是查看的目标玩家。 - 权限:
mcmmo.skills.inspect
(默认OP,可赋予普通玩家允许相互查询)。
-
/party
或/pt
– 派对系统主命令。- 作用: mcMMO的组队/派对系统指令前缀。输入
/party
不带参数时会显示派对子命令帮助。常用子命令有:/party create <名称>
– 创建一个派对。/party invite <玩家>
– 邀请玩家加入你的派对。/party accept
,/party reject
– 接受/拒绝派对邀请。/party quit
– 退出当前派对。/party kick <玩家>
– 将某成员踢出派对(队长用)。/party leader <玩家>
– 转移队长。/party chat
或/p
– 切换派对聊天频道,只派对成员可见。
- 示例:
Steve: /party create Miners
创建名为Miners的派对;Alex: /party invite Bob
邀请Bob加入;Bob执行/party accept
加入。 - 返回信息: 创建或加入时有成功提示(广播给成员:“Bob加入了派对Miners”),邀请发送成功或失败(对方不在线)等提示。
- 权限: 默认所有玩家可使用派对功能。
- 作用: mcMMO的组队/派对系统指令前缀。输入
-
/party toggle
– 切换派对XP共享。- 作用: 队长可开关队伍经验共享。开启后派对成员在一定范围内共享mcMMO经验收益。
- 参数: 无。
- 示例: 队长输入
/party toggle
-> 提示“经验共享 已启用”(再输则禁用)。 - 权限: 派对队长权限(玩家即可用)。
-
/xplock <技能名>
– 锁定经验条显示某技能。- 作用: mcMMO 将玩家经验条用于显示某技能升级进度。使用此命令可以固定经验条只跟踪指定技能的经验,而不自动切换。
- 参数:
<技能名>
要锁定的技能英文名称;留空则取消锁定恢复默认行为。 - 示例:
/xplock mining
将经验条固定显示挖矿技能的经验进度,不管玩家做其他活动。 - 返回信息: 提示经验条已锁定到哪个技能,或者已解锁恢复正常。
- 权限: 所有玩家可用。
-
/mcability <技能名>
– 手动激活技能(旧版用法)。- 说明: 旧版mcMMO通过对应技能命令或右键工具来激活技能。新版本整合为统一
/activate
或上文/mcability
。通常不直接用“/技能名”来激活。 - 例如: 早期版本中,
/serratedstrikes
激活剑术AOE技能;新版中只需手持剑shift+右键。此处了解即可。 - 权限: 玩家拥有对应技能即可使用,无额外权限。
- 说明: 旧版mcMMO通过对应技能命令或右键工具来激活技能。新版本整合为统一
-
各技能命令: mcMMO 为每种技能都提供了同名命令来查看技能细节和能力描述,例如:
/mining
,/woodcutting
,/unarmed
,/archery
,/herbalism
,/excavation
,/acrobatics
,/repair
,/alchemy
等。- 作用: 显示该技能可解锁的被动效果和主动技能说明、下一级需要经验等。
- 示例:
/mining
输出挖矿技能详情:“Double Drop: 几率x%, Super Breaker: 冷却60s ...”。 - 权限: 所有玩家可用。
-
/mcnotify
或/notify
– 切换技能提示。- 作用: 控制在升级或技能冷却结束等事件时,是否在聊天显示提示信息。关闭后将不再收到诸如“技能已就绪!”的提示。
- 参数: 无。
- 示例: 玩家嫌提示刷屏,则输入
/notify
关闭,以后升级只听音效不见提示文字。再次执行可打开。 - 返回信息: 提示已开启或关闭通知。
- 权限: 所有玩家可用。
管理员指令:
-
/mmoedit <玩家> <技能> <等级>
– 编辑玩家技能等级。- 作用: 人为设置某玩家的指定技能等级为给定值。
- 参数:
<玩家>
目标玩家;<技能>
技能英文名;<等级>
要设定的新等级。 - 示例:
/mmoedit Steve mining 50
将Steve的挖矿技能等级设为50(经验值调整为该等级的起始)。 - 返回信息: 如果成功会提示玩家的新等级。如果玩家在线也会被动更新其技能信息。
- 权限:
mcmmo.admin.mmoedit
或 OP。
-
/addlevels <玩家> <技能> <数量>
– 增加技能等级。- 作用: 在玩家当前技能等级基础上增加若干级。
- 参数: 同上;
<数量>
增加的等级数。 - 示例:
/addlevels Alex axes 5
使Alex的斧术技能等级在原有基础上+5。 - 返回信息: 成功则提示新等级。
- 权限:
mcmmo.admin.mmoedit
。
-
/mmoxp <玩家> <技能> <经验>
– 设置技能经验。- 作用: 直接设置玩家某技能的当前经验值。可用来微调经验进度。
- 参数:
<经验>
可为绝对值或相对值(如+100或-100)。 - 示例:
/mmoxp Steve mining +500
给Steve的挖矿技能增加500经验。 - 返回信息: 玩家如果因此升级,会触发升级提示,否则仅提示经验已调整。
- 权限:
mcmmo.admin.mmoedit
。
-
/mcremove <玩家>
– 删除玩家数据。- 作用: 将玩家从mcMMO数据库中移除(清空其所有技能进度)。高危操作,慎用。
- 参数:
<玩家>
目标玩家名。 - 示例:
/mcremove Griefer123
删除此玩家的mcMMO记录。 - 返回信息: 通常仅控制台确认,玩家数据被移除后其技能等级将重置为0。
- 权限:
mcmmo.admin.mcremove
。
-
/mcpurge
– 清除所有玩家数据。- 作用: 清空mcMMO的整个数据库或MySQL数据表(不可逆)。
- 参数: 无。
- 示例:
/mcpurge
移除所有用户的mcMMO进度记录。 - 返回信息: 控制台输出结果。
- 权限:
mcmmo.admin.mcpurge
。
-
/mcrefresh [玩家]
– 刷新技能冷却。- 作用: 重置玩家所有技能的冷却,让其可立即再次使用主动技能。若不指定玩家则刷新执行者自身。
- 参数:
[玩家]
目标玩家,不填则自己。 - 示例:
/mcrefresh Alex
将Alex所有技能冷却归零。 - 返回信息: “Cooldowns have been refreshed”之类提示给执行者。目标玩家若在线不会特别通知,但可马上用技能。
- 权限:
mcmmo.admin.mcrefresh
。
-
/mmoupdate
– 转换数据库。- 作用: 将FlatFile数据转换至MySQL或相反。这个命令用于mcMMO存储方式迁移,一般在后台执行一次即可。
- 权限:
mcmmo.admin.mmoupdate
。
mcMMO 功能概述: 安装mcMMO后,玩家在日常游戏中通过各种行为提升技能等级:
- 挖矿(Mining) 提升:提高双倍掉落几率,主动技能“超级破坏 (Super Breaker)”短时间内极速挖掘;
- 伐木(Woodcutting):高等级有几率一次砍倒整棵树,技能“树人之怒(Tree Feller)”更快砍树;
- 钓鱼(Fishing):随等级提升可钓上宝箱(内含额外战利品),技能“震撼 (Shake)”可从生物身上震出物品;
- 剑术(Swords):增加出血伤害几率,技能“Serrated Strikes”对周围目标造成AOE出血;
- 斧术(Axes):增加重击几率,技能“Skull Splitter”造成范围伤害;
- 格斗(Unarmed):徒手打怪几率缴械,对方武器掉落,技能“Berserk”临时提高徒手伤害并破坏弱方块;
- 射箭(Archery):高等级箭矢暴击、击晕敌人几率上升;
- 驯兽(Taming):提高驯服动物效率,狼获得出血撕咬等能力;
- 修理(Repair):可在铁砧上用材料修复装备,等级高可保留附魔,子技能“神匠(Arcane Forging)”提高修理保留附魔概率;
- 健步(Acrobatics):增加摔落保护概率(翻滚躲避坠落伤害),技能“柔术(Gravity)”几率完全免疫摔落伤害;
- 炼药(Alchemy):酿造药水速度加快,允许酿造特殊药水;
- 淘金(Excavation):挖沙土等方块有几率挖出宝藏(附加掉落物,如硬币、附魔书等),技能“挖掘狂热(Giga Drill Breaker)”快速挖掘土方;
- 冶炼(Smelting):增加矿石冶炼产出经验,偶尔额外产出副产品(如炼铁有几率多产一块铁),以及高等级自动将矿石直接双倍产出。
mcMMO 鼓励玩家练习各种技能,并在达到一定等级时通过聊天提示或提示栏通知“Your [技能] skill leveled up to X!”,伴随音效欢呼。每个技能的主动技能通常通过双击右键工具激活(或者Shift+右键,取决于配置),持续数秒的强化效果,有冷却时间。玩家可以创建派对组队练技能,并分享经验给附近队友。插件高度可配置,可以启用/禁用某些技能或调整经验曲线。使用/mcstats
和/mctop
等命令可以直观看到RPG化的成长体系,为生存玩法增加乐趣。
McmmoGuiV2 插件
McmmoGuiV2(亦称 McMmoView)是 mcMMO 的附属插件,为 mcMMO 提供了图形化用户界面,方便玩家通过GUI查看技能信息、排行榜和执行部分操作,使交互更直观。主要指令:
-
/mcmmoview open [玩家]
– 打开技能GUI界面。- 作用: 打开一个 GUI 菜单,显示玩家各技能的等级、经验进度,并可点选查看详情(相当于
/mcstats
和单技能说明的整合GUI)。如果指定了玩家名且执行者有权限,则打开该玩家的技能界面。 - 参数:
[玩家]
可选,默认为自己。如填写,则为查看他人(需管理权限)。 - 示例: 普通玩家执行
/mcmmoview open
,屏幕出现一个界面,列出自己的所有技能及等级。点击某项技能图标,会进一步弹出该技能详情(例如其被动效果描述、离下一级所需经验等)。管理员执行/mcmmoview open Steve
则可以查看Steve的技能列表(只读)。 - 返回信息: 无文本输出,直接显示 GUI 菜单。
- 权限:
mcmmo.view.open
(具体节点名称视插件版本,默认所有玩家可打开自己的GUI),查看他人则需要mcmmo.view.others
。
- 作用: 打开一个 GUI 菜单,显示玩家各技能的等级、经验进度,并可点选查看详情(相当于
-
/mcmmoview toggle
– 切换GUI替代指令模式。- 作用: 一些版本提供此命令切换,当启用时,玩家执行某些mcMMO指令将自动以GUI方式展现结果,而不是聊天文本。例如打开排行榜时用GUI显示而非文字列表。
- 参数: 无。
- 示例:
/mcmmoview toggle
开启后,玩家执行/mctop
可能直接得到一个排行榜GUI界面而非文本排行。再次执行toggle
恢复默认文本输出模式。 - 返回信息: 提示mcMMO GUI模式已启用/禁用。
- 权限: 一般所有玩家可用(根据需要启用自己的GUI偏好)。
-
/mcmmoview help
– 插件帮助。- 作用: 显示McmmoGuiV2可用指令帮助。(有时也集成在
/mcmmoview open
无参数的输出中)。 - 权限: 无特别限制。
- 作用: 显示McmmoGuiV2可用指令帮助。(有时也集成在
(注: McmmoGuiV2的大部分功能通过GUI交互,无需大量命令。因此指令较少。主要就是/mcmmoview open
。该插件的目的是优化mcMMO的用户体验,将繁杂的技能信息集中在界面显示,玩家无需记忆太多指令。安装后玩家也可以通过诸如按键菜单或者NPC触发GUI。)
Multiverse-Core 插件
Multiverse-Core 是多世界管理插件,提供创建、导入、传送多个世界的功能。其主要指令及用法:
-
/mv help [页码]
– Multiverse 帮助。- 作用: 显示Multiverse可用命令的帮助列表,分多页。
- 示例:
/mv help 2
查看帮助第2页。 - 权限: 默认OP。
-
/mv create <世界名> <环境> [参数]
– 创建新世界。- 作用: 按指定名称和环境类型创建一个新世界,并自动加载。环境参数如
NORMAL
(普通主世界)、NETHER
(下界)、END
(末地)。可附加-t flat
创建超平坦、-s <种子>
指定种子等。 - 参数:
<世界名>
新世界的文件夹/名称(不得与现有重复);<环境>
环境类型(正常/下界/末地/自定义世界类型)。可选参数包括:-g <生成器插件或空白>
使用特定世界生成器(例如空岛插件);-t <样式>
地形样式,如flat
平坦;-s <种子>
指定世界种子;-n
不自动加载生成(仅创建文件)。
- 示例:
/mv create myworld NORMAL -s 12345
创建一个名为“myworld”的正常世界,使用种子12345。 - 返回信息: 控制台和执行者会看到创建进度,例如“Starting creation of world 'myworld'...”,完成后“Complete!”。
- 权限:
multiverse.core.create
(默认OP)。
- 作用: 按指定名称和环境类型创建一个新世界,并自动加载。环境参数如
-
/mv remove <世界名>
– 注销世界。- 作用: 将世界从Multiverse管理中移除(卸载),但不删除世界文件。此操作后需手动删除文件才能彻底移除世界。
- 参数:
<世界名>
要移除的世界。 - 示例:
/mv remove oldworld
把名为oldworld的世界从插件中注销,不再加载。 - 返回信息: 提示世界已移除。
- 权限:
multiverse.core.remove
.
-
/mv delete <世界名>
– 删除世界。- 作用: 卸载并永久删除指定世界的文件(需二次确认)。
- 参数:
<世界名>
要删除的世界。 - 示例:
/mv delete testworld
将卸载并删除testworld文件夹,但在执行此命令后需输入/mv confirm
确认删除。 - 返回信息: 执行后提示“Please confirm deletion of 'testworld' by typing /mv confirm”。确认后才真正删除并提示完成。
- 权限:
multiverse.core.delete
。
-
/mv confirm
– 确认危险操作。- 作用: 用于确认需要二次确认的操作(如删除世界)。在执行
/mv delete
后输入此命令确认。 - 示例:
/mv confirm
在提示后10秒内执行,即可确认删除pending状态的世界。 - 返回信息: 若成功,则通知世界已删除;超时则提示操作已取消。
- 权限: 与触发的前置命令相同权限(删除世界需OP)。
- 作用: 用于确认需要二次确认的操作(如删除世界)。在执行
-
/mv import <文件夹名> <环境>
– 导入已有世界。- 作用: 将服务器已有的世界文件夹导入Multiverse管理。环境参数同
create
命令。 - 参数:
<文件夹名>
已存在于服务器目录下的世界文件夹名称;<环境>
该世界类型(NORMAL/NETHER/END等)。 - 示例: 上传了一个名为Adventure的世界文件夹后,执行
/mv import Adventure NORMAL
将其加载进服务器。 - 返回信息: 和create类似的加载进度消息,完成则提示成功导入。
- 权限:
multiverse.core.import
.
- 作用: 将服务器已有的世界文件夹导入Multiverse管理。环境参数同
-
/mv load <世界名>
– 加载未加载的世界。- 作用: 如果某世界存在于Multiverse配置但当前未加载(如服务器启动时被设置为不加载),可用此命令加载它。
- 参数:
<世界名>
目标世界名。 - 示例:
/mv load skylands
将加载名为skylands的世界进内存。 - 返回信息: 加载成功或失败提示。
- 权限:
multiverse.core.load
.
-
/mv unload <世界名>
– 卸载世界。- 作用: 将指定世界从内存中卸载(释放资源),但保持在Multiverse配置中可日后load。
- 参数:
<世界名>
要卸载的世界。 - 示例:
/mv unload minigame
卸载名为minigame的世界。 - 返回信息: 成功则提示世界已卸载。如果有玩家在该世界需先转移他们或者失败。
- 权限:
multiverse.core.unload
.
-
/mvtp [玩家] <目标世界> [目的地]
– 传送玩家到另一世界。- 作用: 将自己或指定玩家传送到某世界。可指定传送目标如世界的Spawn点或坐标(需安装MV-Portals配合点)。
- 参数:
[玩家]
可选,默认自己;<目标世界>
要去的世界名;[目的地]
可选,如该世界的某个别名位置。一般不填则去世界默认出生点。 - 示例:
/mvtp world_nether
自己前往Nether世界的默认出生点;/mvtp Alex CreativeWorld
把Alex传送到CreativeWorld世界。 - 返回信息: “Teleporting to <世界>”并完成传送。如世界未加载会错误提示。
- 权限:
multiverse.teleport.self
允许自传,multiverse.teleport.other
允许传别人。
-
/mv list
– 列出所有世界。- 作用: 显示当前服务器已加载的所有世界及其属性。
- 参数: 无。
- 示例:
/mv list
可能输出:===[ Multiverse World List ]=== world - ENV: NORMAL SEED: 12345 [spawn: 0,65,0] world_nether - ENV: NETHER SEED: 12345 [spawn: 10,64,8] world_the_end - ENV: THE_END SEED: 12345 [spawn: 0,50,0] ...
- 返回信息: 包括世界名、环境、种子、生成器等信息和出生点坐标。
- 权限: 所有人可用(无敏感信息,普通玩家也可查看世界列表)。
-
/mv info <世界名>
– 查看世界信息。- 作用: 显示特定世界的详细设置,如动物/怪物是否开启、PVP是否开启、世界边界、难度等Multiverse配置。
- 示例:
/mv info world
列出主世界的详细属性配置。 - 返回信息: 多行信息,例如“Animals: true, Monsters: true, PVP: false, Difficulty: HARD, RespawnWorld: world” 等。
- 权限:
multiverse.core.info
.
-
/mv modify set <属性> <值> <世界名>
– 修改世界属性。- 作用: 更改某个已加载世界的设置选项(保存在plugins/Multiverse/Worlds.yml)。可修改例如
difficulty
(难度),animals
(动物开关),monsters
(怪物开关),pvp
(PVP开关),currency
(进入收费)等。 - 参数:
<属性>
要修改的属性键;<值>
新值;<世界名>
目标世界。 - 示例:
/mv modify set pvp true world_nether
打开Nether世界的PVP。 - 返回信息: “Property pvp was set to true for world_nether”。若属性名错误会提示无效。
- 权限:
multiverse.core.modify
(默认OP)。
- 作用: 更改某个已加载世界的设置选项(保存在plugins/Multiverse/Worlds.yml)。可修改例如
-
/mv flag <世界名> <flag> <值>
– 设置世界特殊Flag。- 作用: 设置Multiverse特殊flag,例如
keepSpawnInMemory
(保持spawn加载),autoheal
(自动治愈),price
(进入价格)等。不常用,此命令有时归于/mv modify
,具体用法参考官方文档。 - 示例:
/mv flag world autoheal false
关闭world自动治愈玩家功能。 - 权限:
multiverse.core.modify
.
- 作用: 设置Multiverse特殊flag,例如
-
/mv setspawn
– 设置当前世界spawn。- 作用: 将执行者所在位置设置为所在世界的新spawn点(重生点)。相当于每个世界的/setspawn。
- 示例: 在CreativeWorld世界某建筑内执行
/mv setspawn
,之后玩家若在该世界使用/spawn
或死亡重生将来到此处。 - 返回信息: 提示Spawn点已更新(坐标)。
- 权限:
multiverse.core.spawn.set
。
-
/mv spawn [世界名]
– 前往世界spawn。- 作用: 将自己传送到指定世界的spawn点。如果不指定世界则传送到当前世界spawn(类似
/spawn
)。 - 示例:
/mv spawn CreativeWorld
把自己送到CreativeWorld的世界出生点。 - 返回信息: 传送成功则无特别提示,仅玩家位置改变。
- 权限:
multiverse.core.spawn.self
(默认所有玩家允许访问spawn,也可通过Essentials等接管)。
- 作用: 将自己传送到指定世界的spawn点。如果不指定世界则传送到当前世界spawn(类似
-
/mv coord <世界名>
– 获取世界spawn坐标。- 作用: 显示指定世界的spawn点坐标(如果不想传送仅想知道坐标)。
- 示例:
/mv coord world_nether
输出Nether的spawn坐标。 - 返回信息: 例如“Spawn of world_nether is at: X:0 Y:64 Z:0”。
- 权限:
multiverse.core.spawn.self
.
-
/mv who
– 列出各世界玩家。- 作用: 显示每个世界当前在线的玩家列表。
- 返回信息: 如:
world - 5 players: Alice, Bob, ... world_nether - 2 players: Charlie, Dave world_the_end - 0 players
- 权限:
multiverse.core.list
.
权限说明: Multiverse-Core权限通常默认为OP才能使用关键世界管理命令。可按需给予管理员组。如果想让普通玩家访问多世界,可开放 /mvtp
(跨世界传送)权限给他们并设置好访问权限或者通过/warp
、传送门插件来引导。
小提示: 当创建新世界后,会自动生成对应的 Nether 和 End 世界文件夹(如果在配置中允许),管理这些附属世界时,也需要使用Multiverse的命令(例如/mv remove world_nether
移除Nether)。Multiverse-Core常和其附加组件一起使用,如Multiverse-Portals(自定义传送门)、Multiverse-Inventories(不同世界背包隔离)等,分别有各自的指令。Multiverse-Core本身的以上指令主要围绕世界的创建、加载和传送。
NoMoreCooked 插件
NoMoreCooked 是一个专注于食物保鲜与腐坏机制的插件,它为食物添加了保质期和冰箱道具,使食物会在一定时间后腐败变质。这是较为特殊的生存设定插件。主要管理指令:
/nomorecooked reload
– 重载插件配置。- 作用: 重新加载NoMoreCooked的配置文件,包括食物保质期设置、冰箱效果、语言文件等。
- 参数: 无。
- 示例: 修改配置文件后执行
/nomorecooked reload
,插件将应用新的保质期规则,比如更改了牛排的腐坏时间等。 - 返回信息: 控制台会提示插件配置已重载。如果重载过程中发现配置错误也会报告。玩家执行则通常无输出或简单提示重载完成。
- 权限: 需要管理员权限(插件没有细分权限节点,默认OP可执行)。
(NoMoreCooked 插件聚焦于游戏机制调整,通常没有面向普通玩家的命令,玩家交互主要通过物品栏提示和冰箱GUI进行。例如玩家可以制作“冰箱”来延长食物寿命,右键打开冰箱GUI存放食物,没有特定命令。此外,如果配置了命令,则玩家食用腐坏食物会触发debuff等,但都不需要玩家手动输入命令。总之,NoMoreCooked除了重载外几乎无命令操作。)
PlaceholderAPI 插件
PlaceholderAPI 是一个占位符插件,本身不直接提供游戏玩法功能,而是供其他插件获取变量信息(如玩家名、经济余额等)的统一接口。常用指令主要涉及下载/管理扩展和测试解析占位符:
-
/papi help
– 显示 PlaceholderAPI 帮助。- 作用: 列出PlaceholderAPI可用的子命令说明。
- 参数: 无。
- 示例:
/papi help
列出 ecloud 子命令和 parse 用法等。 - 返回信息: 帮助列表,例如:
/papi list – 列出已安装的扩展 /papi parse <玩家> <文本> – 测试解析占位符 /papi ecloud <子命令> – 管理占位符云端扩展 ...
- 权限: 默认OP。
-
/papi list
– 列出已加载的占位符扩展。- 作用: 显示目前PlaceholderAPI已激活的所有占位符扩展插件及其版本。
- 参数: 无。
- 示例:
/papi list
可能输出:Installed expansions: Vault 1.7.0, Player 2.0.1, Essentials 1.2.0, ... (绿色表示已加载)
- 返回信息: 分页列出扩展名和版本。其中绿色表示已安装且启用,红色(若有)表示已安装但未启用(可能需要更新)。
- 权限: 默认OP。
-
/papi parse <玩家|me|--null> <文本>
– 解析占位符。- 作用: 测试解析一段文本中的占位符并输出结果。用于检查占位符是否工作。
- 参数:
<玩家|me|--null>
指定用哪个玩家的数据解析占位符,填me
表示自己,--null
表示没有玩家(用于不需要玩家的占位符);<文本>
包含占位符的字符串。 - 示例:
/papi parse me Hello %player_name%, you have %vault_balance% money.
- 返回信息: 解析后输出,如:“Hello Steve, you have 1500 money.”假设执行者名Steve且Vault余额1500。
- 权限: 默认OP(普通玩家一般不需要使用此命令,只供管理员调试)。
-
/papi parseother <玩家1> <玩家2> <文本>
– 跨玩家关系占位符解析。- 作用: 解析涉及两个玩家关系的占位符(如比较两个玩家数据)。
- 参数:
<玩家1> <玩家2> <文本>
将文本中的占位符按玩家1和2的关系解析,如%rel_friends%
等。 - 示例:
/papi parseother Alice Bob %placeholder_relational_example%
(具体用法较少见,此为高级功能)。 - 权限: 默认OP。
-
/papi ecloud list [<作者>|installed]
– 列出云端扩展。- 作用: 列出PlaceholderAPI云端可用的扩展。不带参数默认列出所有可下载扩展名称(很多页);
installed
参数列出本地已安装扩展;<作者>
可筛选某作者发布的扩展。 - 示例:
/papi ecloud list installed
列出已安装扩展(等价于/papi list
);/papi ecloud list clip
列出作者clip发布的扩展插件。 - 返回信息: 例如“123 expansions found: [1] PlaceholderAPI, [2] Vault, [3] Player, ...”分页展示。
- 权限: 默认OP。
- 作用: 列出PlaceholderAPI云端可用的扩展。不带参数默认列出所有可下载扩展名称(很多页);
-
/papi ecloud download <扩展名>
– 下载占位符扩展。- 作用: 从PlaceholderAPI云端仓库下载指定的扩展并安装。需要扩展名称正确匹配。下载后通常需
/papi reload
加载生效。 - 参数:
<扩展名>
扩展插件名称(注意大小写)。 - 示例:
/papi ecloud download Vault
下载Vault扩展(提供Vault经济和权限占位符)。 - 返回信息: 成功时提示扩展已下载并安装(会放入/plugins/PlaceholderAPI/expansions/目录),如需要更新也会说明。
- 权限: 默认OP。
- 作用: 从PlaceholderAPI云端仓库下载指定的扩展并安装。需要扩展名称正确匹配。下载后通常需
-
/papi ecloud update <扩展名>
– 更新扩展。- 作用: 检查并更新本地已安装的某个扩展到最新版本。
- 示例:
/papi ecloud update Player
检查云端并更新Player扩展。 - 返回信息: 如果有更新则下载替换旧版,提示更新完成。无更新则提示已是最新版本。
- 权限: 默认OP。
-
/papi ecloud uninstall <扩展名>
– 卸载扩展。- 作用: 移除指定扩展。将删除对应文件并停止提供其占位符。
- 示例:
/papi ecloud uninstall Vault
卸载Vault扩展。 - 返回信息: 扩展已卸载的提示。
- 权限: 默认OP。
-
/papi ecloud info <扩展名>
– 查看扩展信息。- 作用: 显示扩展的简介、作者、版本等详细信息。
- 示例:
/papi ecloud info Essentials
显示Essentials扩展的信息和使用的占位符列表链接。 - 返回信息: 包括扩展描述、下载次数、可用占位符示例等。
- 权限: 默认OP。
-
/papi reload
– 重载 PlaceholderAPI。- 作用: 重新加载PlaceholderAPI的核心和已安装扩展。一般在下载新扩展或更新后执行以使其生效。
- 示例:
/papi reload
- 返回信息: “PlaceholderAPI reloaded” 等确认信息。如果配置文件比如messages.yml有更改也会一并加载。
- 权限: 默认OP。
使用说明: PlaceholderAPI 本身没有一般玩家使用的功能,它的作用在于提供统一的%placeholder%
格式变量,供聊天格式、记分板、公告板等插件显示动态信息。例如,在LuckPerms配合Vault时,可用%vault_prefix%
显示玩家前缀,%player_ping%
显示延迟。普通玩家不会直接使用PAPI命令,但管理员需要通过/papi ecloud
下载对应扩展以支持所需插件(如要显示经济余额则下载Vault扩展、显示玩家属性则下载Player扩展等)。下载后通过/papi list
确认安装、/papi parse
测试。PAPI 本身无复杂权限,通常OP全权管理,需要给普通玩家的是其他插件显示占位符的权限而非PAPI权限。总之,PlaceholderAPI作为底层支持,其命令主要围绕“下载/更新扩展”和“测试解析”这两块。
PlayerTitle 插件
PlayerTitle 是一个玩家称号插件,允许管理员创建各种称号并赋予玩家。玩家可以在称号商店购买称号、在聊天或头顶显示称号,称号还可带有属性增益(Buff)。主要指令如下:
-
/playertitle
或/ptitle
– 主命令/打开称号菜单。- 作用: 不带参数执行时,打开玩家的称号主界面,包括已拥有称号、称号商店等选项的GUI,让玩家可以装备称号或购买新称号。
- 参数: 无(直接打开GUI)。
- 示例: 玩家输入
/ptitle
,将看到一个界面,其中一栏显示自己已拥有的称号,可以点选装备/卸下称号;另一栏可进入称号商店。 - 返回信息: 无聊天输出,直接显示称号GUI界面。
- 权限: 普通玩家需有
playertitle.use
权限才能使用称号系统(插件通常默认启用)。
-
/playertitle shop
– 打开称号商店。- 作用: 直接打开称号购买界面。商店中列出可供购买的称号列表,可能按类型分类。玩家可点击花费虚拟币或道具来购买限时或永久称号。
- 参数: 无。
- 示例:
/ptitle shop
打开称号商城GUI,让玩家浏览可购买称号及价格。 - 返回信息: 无文本输出,出现商店界面。如果玩家没有任何称号可买也许界面为空或提示暂无。
- 权限:
playertitle.use
(具有使用权限即可逛商店)。
-
/playertitle equip <称号ID>
– 装备称号。- 作用: 将某个已拥有的称号设置为当前激活状态,使之在聊天、玩家头顶等显示。也可通过GUI点击实现,但命令提供快捷方式。
- 参数:
<称号ID>
要装备的称号内部ID(非显示名称)。称号ID由管理员创建时指定,用于指令操作。 - 示例:
/ptitle equip dragon_slayer
装备ID为dragon_slayer的称号,玩家的称号将显示为其设定的展示名,比如“龙之刃”。 - 返回信息: 聊天提示如“你已装备称号 [龙之刃]”,并且之后说话时该称号会在名字前后显示(具体显示格式视插件配置)。
- 权限: 普通玩家需要已经解锁该称号才可装备,无特别权限要求。装备不同称号可能也可以用GUI,所以命令只是辅助。
-
/playertitle remove
– 卸下当前称号。- 作用: 移除玩家当前佩戴的称号,不显示任何称号。
- 参数: 无。
- 示例:
/ptitle remove
玩家将不再显示称号。 - 返回信息: “你已移除当前称号。” 玩家聊天/Tab列表将恢复无称号状态。
- 权限:
playertitle.use
。
-
/playertitle create <称号ID> <显示名> [类型]
– 创建新称号(管理员)。- 作用: 定义一个新的称号。称号包括内部ID(英文,用于命令和权限)、显示名称(可含颜色格式)、类型(如永久/限时/活动等分类)。通常也可以通过GUI管理界面创建称号,但命令提供快速途径。
- 参数:
<称号ID>
唯一标识(英文);<显示名>
在聊天/GUI中看到的称号名称,可用&颜色代码;[类型]
可选分类,比如default
默认、vip
VIP专属等(具体取决于插件配置)。 - 示例:
/ptitle create king "&6国王" vip
创建一个ID为“king”的称号,显示为金色的“国王”,分类为vip(或需要VIP购买)。 - 返回信息: 若成功,提示称号已创建,可在管理GUI或配置中看到它。若ID重复会报错。
- 权限:
playertitle.admin
。
-
/playertitle delete <称号ID>
– 删除称号(管理员)。- 作用: 移除一个已存在的称号定义。会同步从玩家拥有列表中清除(包括收回所有玩家此称号)。
- 参数:
<称号ID>
要删除的称号标识。 - 示例:
/ptitle delete king
删除先前创建的“king”称号。 - 返回信息: 确认称号已删除。如果有玩家拥有该称号,也会被自动剥夺并提示。
- 权限:
playertitle.admin
。
-
/playertitle give <玩家> <称号ID> [天数]
– 授予玩家称号(管理员)。- 作用: 直接赋予某玩家一个称号。可指定称号有效期(天数),不指定则默认为永久。
- 参数:
<玩家>
目标玩家;<称号ID>
要给予的称号;[天数]
有效天数,填0
或不填表示永久。 - 示例:
/ptitle give Alex king 30
给Alex赋予“king”称号30天。30天后称号自动失效。 - 返回信息: 执行者收到确认:“已赋予 Alex 称号 [国王] (30天)”。玩家Alex若在线会收到类似邮件或提示通知称号获得。
- 权限:
playertitle.admin
。
-
/playertitle take <玩家> <称号ID>
– 收回玩家称号(管理员)。- 作用: 移除指定玩家拥有的某称号。通常用于违规获得或手动剥夺称号。
- 参数:
<玩家>
目标玩家;<称号ID>
要收回的称号标识。 - 示例:
/ptitle take Bob vip_title
收回Bob的VIP称号。 - 返回信息: 提示已移除Bob的该称号,Bob将无法再使用此称号。
- 权限:
playertitle.admin
。
-
/playertitle setprefix <称号ID> <聊天前缀>
– 设置称号前缀(管理员)。- 作用: 定义称号在聊天中显示的前缀/格式。某些插件允许每个称号自定义在玩家名旁显示的特殊样式(包括附加Buff属性显示)。
- 参数:
<称号ID>
;<聊天前缀>
带颜色格式的字符串,可包含PlaceholderAPI变量表示称号名等。 - 示例:
/ptitle setprefix king "&6[国王] "
设置king称号在聊天中以“[国王]”标识。 - 返回信息: 确认称号显示格式已更新。
- 权限:
playertitle.admin
。
-
/playertitle reload
– 重载 PlayerTitle 配置。- 作用: 重新加载插件配置、称号数据等。通常更新称号列表或商店设置后执行。
- 参数: 无。
- 示例:
/ptitle reload
- 返回信息: 控制台提示配置重载成功或错误。
- 权限:
playertitle.admin
。
称号功能说明:
- 玩家可以拥有多个称号但一次只能装备一个。称号可在聊天、Tab列表、头顶显示。某些称号附带Buff(如提升属性),当称号装备时Buff生效。
- 称号可以设置为限时:比如活动称号30天,到期后自动失效。插件会在称号到期时自动移除,并可提醒玩家。
- 插件提供称号商店GUI(
/ptitle shop
),里面称号可以设定不同获取方式:货币购买(需要Vault经济)、点券购买(需PlayerPoints)、物品兑换、权限解锁(如VIP自动拥有特殊称号)等。购买后称号进入玩家仓库,可自由装备。 - 玩家自己的称号管理界面(
/playertitle
)通常有称号背包(显示已拥有称号列表,可选择装备)、称号商店、称号任务(如果插件设计成通过某些成就获得称号,则会显示完成进度)等选项。 - 管理员可以通过后台配置文件或命令创建称号。称号通常包含:唯一ID、显示名称、类型(分类或获取方式)、价格、时限、Buff效果等属性。
- 权限: 除
playertitle.admin
给管理人员外,还可能有playertitle.use
(允许玩家参与称号系统),playertitle.shop
(允许打开商店),以及每个称号可能对应一个权限(如playertitle.title.king
,授予则玩家直接拥有该称号,无需购买)。这些视插件具体实现而定。
总之,PlayerTitle丰富了玩家的个性展示和奖励体系,通过称号来标识身份或成就。管理员应设计合理的称号获取途径(比如完成困难任务、累计上线天数、参与活动等)以增加玩法乐趣,并利用命令或GUI给予/回收称号。
PlugManX 插件
PlugManX 是一个插件管理工具,允许在服务器运行时热加载、卸载插件、查看插件信息等。它为管理员提供快速调试插件的命令。主命令为 /plugman
。主要子命令如下:
-
/plugman list [-v]
– 列出服务器所有插件。- 作用: 列出当前服务器已加载的所有插件名称。加参数
-v
可同时显示插件版本。 - 示例:
/plugman list
输出类似:“Plugins (10): WorldEdit, Vault, Essentials, ...”;/plugman list -v
则输出“Essentials (v2.20.0), Vault (v1.7.3)...”。 - 权限:
plugman.list
(默认OP)。
- 作用: 列出当前服务器已加载的所有插件名称。加参数
-
/plugman info <插件名>
– 显示插件信息。- 作用: 提供指定插件的详细信息,包括版本、作者、状态、依赖等。
- 参数:
<插件名>
支持部分名称匹配或完整名称,不区分大小写。 - 示例:
/plugman info Essentials
将显示Essentials插件的信息,如版本号、作者列表、启用状态、主类路径、依赖插件等。 - 返回信息: 多行输出,如:
Name: Essentials Version: 2.20.0 Author(s): drtshock, etc Status: Enabled Depend: [Vault] SoftDepend: [WorldGuard]
- 权限:
plugman.info
。
-
/plugman usage <插件名>
– 列出插件注册的指令。- 作用: 查看某插件向服务器注册了哪些指令及其用法。
- 示例:
/plugman usage Essentials
列出Essentials插件的全部命令(很多),以及每个命令的简要描述或指向。 - 返回信息: 例如:
Essentials: /spawn – Teleport to spawn /home – Teleport to home ...
- 权限:
plugman.usage
。
-
/plugman lookup <命令>
– 查找指令属于哪个插件。- 作用: 当不知道某个指令由哪个插件提供时,可用此命令查询。
- 参数:
<命令>
不需要斜杠。 - 示例:
/plugman lookup fly
可能输出“fly – Provided by Essentials”表示/fly
命令来自Essentials插件。 - 权限:
plugman.lookup
。
-
/plugman enable <插件名|all>
– 启用插件。- 作用: 加载并启用指定插件(若其当前被禁用/卸载),或使用
all
启用全部插件。 - 示例:
/plugman enable WorldEdit
尝试启用WorldEdit插件。如果之前使用/plugman disable停用了它,则此命令会重新启动它。 - 返回信息: 成功则提示“WorldEdit enabled.” 如果插件已在运行则会提示已启用或者无效操作。
- 权限:
plugman.manage
或更具体的plugman.enable
。PlugManX文档指明所有管理类操作OP可用。
- 作用: 加载并启用指定插件(若其当前被禁用/卸载),或使用
-
/plugman disable <插件名|all>
– 禁用插件。- 作用: 停止指定插件。被停止的插件其所有功能和监听都会取消,但注意仅暂停而未卸载JAR。
all
参数可一次停用所有插件(慎用)。 - 示例:
/plugman disable Essentials
将停用Essentials插件(玩家命令将不可用,相关功能停摆)。 - 返回信息: “Essentials disabled.” 若插件拒绝被停用(某些插件不支持动态卸载)则可能报错或不完全停用。
- 权限:
plugman.disable
。
- 作用: 停止指定插件。被停止的插件其所有功能和监听都会取消,但注意仅暂停而未卸载JAR。
-
/plugman restart <插件名|all>
– 重启插件。- 作用: 相当于
disable
后立即enable
指定插件,实现快速重载效果。 - 示例:
/plugman restart Vault
先停用Vault再启用Vault,可用于调试Vault相关问题。 - 返回信息: 组合上面启用和禁用的提示:插件已禁用又已启用。
- 权限:
plugman.restart
。
- 作用: 相当于
-
/plugman reload <插件名|all>
– 重载插件。- 作用: 卸载并重新加载插件JAR,实现彻底重载。和restart略有不同(restart不重新读JAR,只stop再start;reload会重新实例化插件类)。
- 示例:
/plugman reload Essentials
卸载Essentials再载入Essentials,实现类似完全重启。 - 返回信息: “Essentials reloaded.”或者如果插件不兼容动态加载可能会有异常提示。
- 权限:
plugman.reload
。
-
/plugman load <文件名>
– 加载新插件。- 作用: 在服务器运行中加载一个尚未加载过的插件JAR包。文件名要与
plugins
目录下jar文件名匹配。 - 示例: 将AuthMe.jar上传到plugins后,不重启直接执行
/plugman load AuthMe.jar
即可加载AuthMe插件。 - 返回信息: “AuthMe loaded.” 若文件不存在或插件内部错误会提示找不到插件或加载失败原因。
- 权限:
plugman.load
。
- 作用: 在服务器运行中加载一个尚未加载过的插件JAR包。文件名要与
-
/plugman unload <插件名>
– 卸载插件。- 作用: 将指定插件从内存中卸载并移除其指令和监听器。相比disable,它会释放插件所占用的Java类,以便可以重新load新版。
- 示例:
/plugman unload Essentials
完全卸载Essentials插件。之后可更新JAR再/plugman load。 - 返回信息: “Essentials unloaded.”
- 权限:
plugman.unload
。
-
/plugman check <插件名|all> [-f]
– 检查插件更新。- 作用: 查询指定插件是否有更新版本(需要插件在BukkitDev有Project ID)。
all
可检查全部插件。-f
表示强制检查忽略缓存。 - 示例:
/plugman check EssentialsX
检查EssentialsX最新版本,若当前版本过旧会提示可更新。 - 返回信息: 如果插件已是最新,会显示“EssentialsX is up-to-date.” 若有更新,则显示最新版本号并提示可下载。
- 权限:
plugman.check
。
- 作用: 查询指定插件是否有更新版本(需要插件在BukkitDev有Project ID)。
-
/plugman dump
– 导出插件列表。- 作用: 将当前插件列表及版本信息输出至文件(通常plugins目录下的
plugins.txt
或控制台),方便记录。 - 返回信息: 提示Dump已完成和文件保存路径。
- 权限:
plugman.dump
。
- 作用: 将当前插件列表及版本信息输出至文件(通常plugins目录下的
-
/plugman help
– PlugManX 帮助。- 作用: 列出PlugManX自身指令的帮助。
- 示例:
/plugman help
- 返回信息: 简要列出如上指令说明。
- 权限:
plugman.help
。
权限: PlugManX 有一个plugman.admin
节点(默认OP)涵盖所有子命令;或者可以针对性赋予如plugman.reload
, plugman.load
等。一般情况下,此插件命令具备较高风险(频繁加载卸载插件可能导致资源未释放完全),因此应只给予有经验的管理员使用,普通管理也可通过传统restart来避免问题。
注意: 并非所有插件都完全支持PlugMan的热加载/卸载。例如权限、数据库类插件动态卸载可能导致内存残留或数据丢失。使用/plugman reload
也不能保证等同于服务器重启的效果。建议将PlugMan用于开发测试或小插件管理,重大插件的更换仍以服务器重启为稳妥。尽量不要对核心插件频繁使用PlugMan进行操作。
ProtocolLib 插件
ProtocolLib 是一个供开发者截获和修改游戏封包的库插件,本身很少需要玩家或管理员直接交互。ProtocolLib 的指令主要供管理员调试。主命令为**/protocol
(可简写/prot
),以及/packet
**子命令。常见用法:
-
/protocol config
– 重载配置。- 作用: 重新加载ProtocolLib配置文件(protocol.yml),一般用于调整监听选项。
- 示例:
/protocol config
- 返回信息: 控制台提示“Configuration reloaded.”
- 权限:
protocol.admin
(默认OP)。
-
/protocol check
– 检查更新。- 作用: 检查是否有ProtocolLib的新版本(连接BukkitDev)。
- 示例:
/protocol check
- 返回信息: 若有新版本将提示可用版本号,否则提示已是最新。
- 权限:
protocol.admin
。
-
/protocol update
– 下载更新。- 作用: 自动下载最新版本的ProtocolLib插件jar到服务器(需要重启生效)。
- 示例:
/protocol update
- 返回信息: 如成功发起,将提示已下载更新版本Jar,需要重启生效。
- 权限:
protocol.admin
。
-
/protocol timings
– 封包性能监控。- 作用: 切换ProtocolLib的封包处理计时监控。如果开启,能度量每个插件处理封包耗时。调试服务器性能瓶颈用。
- 示例:
/protocol timings
- 返回信息: “Packet timings enabled/disabled.”
- 权限:
protocol.admin
。
-
/protocol listeners
– 列出封包监听。- 作用: 显示哪些插件正在使用ProtocolLib监听哪些封包类型。这对找出哪个插件修改了特定封包很有用。
- 示例:
/protocol listeners
- 返回信息: 列出每个注册监听器的插件、监听的封包ID或名称。如:“Plugin X: Listening on Packet PLAY_ENTITY_EFFECT (Serverbound)”。
- 权限:
protocol.admin
。
以上/protocol
子命令适用于管理员和调试,不涉及普通玩家。
-
/packet add <client|server|both> <封包ID_start> [ID_end] [detailed]
– 添加封包调试监听。- 作用: ProtocolLib 提供调试模式,可以将指定范围的封包日志打印出来。
add
命令用于开始监听。 - 参数:
<client|server|both>
指定监听客户端发来的封包、服务器发送的封包或两者;<封包ID_start>
封包ID或名称(可用数值或协议名);[ID_end]
可选,如果要监听一个范围,如从ID 10到15;[detailed]
可选,如果加入此标志将打印封包详细内容(所有字段)。 - 示例:
/packet add server 0 100
将监听ID 0到100范围内服务器发送的封包。/packet add client 0 detailed
监听客户端发来的ID0封包并详细输出其数据。 - 返回信息: 提示已添加调试监听。之后符合条件的封包将输出在控制台。
- 权限:
protocol.admin
。
- 作用: ProtocolLib 提供调试模式,可以将指定范围的封包日志打印出来。
-
/packet remove <封包ID|all>
– 移除封包调试监听。- 作用: 停止先前添加的特定封包调试监听。可用
all
移除全部。 - 示例:
/packet remove 0
停止监听ID 0封包。/packet remove all
停止所有监听。 - 返回信息: 确认监听已移除。
- 权限:
protocol.admin
。
- 作用: 停止先前添加的特定封包调试监听。可用
(普通服务器管理员几乎无需使用/packet
系列命令,这是给开发者调试封包之用。当/packet add
监听后,服务器控制台将刷大量数据,不可长时间开启。ProtocolLib没有日常用途的指令。)
小结: ProtocolLib 作为工具库,通常不需要人工操作。服务器管理员只需确保其安装正确,ProtocolLib会自动为其他插件提供接口。若遇到封包相关的疑难问题,可用上述指令进行排查,例如/protocol listeners
查看是不是某插件拦截了特定封包导致异常。如果不涉及此类调试场景,可以忽略ProtocolLib的命令部分。
qsaddon-bluemap 插件
qsaddon-bluemap 是 QuickShop-Hikari 与 BlueMap 的联动附加插件。它的功能是在 BlueMap 在线地图上显示 QuickShop 商店的标记,使玩家可在地图上查看商店位置及商品信息。这个附加插件通常不需要直接的玩家指令,安装并正确配置后,它会自动将商店信息同步到 BlueMap。
- 指令: 无玩家可用指令。qsaddon-bluemap 不提供需要手动执行的命令。它工作的方式是在后台监听 QuickShop 商店的创建、删除事件,然后调用 BlueMap API在地图上添加或移除标记点。
- 配置: 如需调整标记显示样式、刷新频率,可修改其配置文件(通常位于 QuickShop/Addon/bluemap.yml)后重启服务器或重载插件。
可能的管理命令:
/qsbluemap reload
– 如果此附加插件实现了重载指令,可以通过它重载自身配置。但根据一般设计,此插件大多与QuickShop一起重载。也可能也接受/quickshop reload
时一起重载。
权限: 无特别权限。qsaddon-bluemap对玩家透明,不影响游戏内权限。管理员只需确保 QuickShop-Hikari 和 BlueMap 都正常运行,本插件会自动桥接两者。
因此,本附加插件无需管理员日常干预。一旦安装:当玩家创建一个商店,BlueMap地图上就会出现对应图标;当商店关闭或售空,也会更新。只有在需要关闭此功能或更改展示效果时,才修改配置。若担心性能,可在配置中调整同步频率。
QuickShop-Hikari 插件
QuickShop-Hikari 是一个高性能的箱子商店插件,允许玩家通过箱子+告示牌的方式创建商店买卖物品。QuickShop 大部分操作通过交互实现,但也提供一些管理指令。主要指令和用法:
-
/qs
或/quickshop
– 主命令。- 作用: 不带参数执行会显示QuickShop的帮助信息/版本信息。也作为其他子命令的前缀。
- 返回信息: 插件版本、可用子命令列表说明。例如:
QuickShop Hikari 版本 x.x.x 子命令: unlimited – 切换商店无限模式 setowner – 更改商店所有者 price – 更改商店价格 ...
- 权限: 普通玩家可用(仅查看帮助)。
-
/quickshop unlimited
– 切换无限库存模式。- 作用: 将当前瞄准的商店(或站在其旁的商店)的库存设为“无限”。“无限商店”在售卖时不会减少库存/在收购时不会装满——俗称服务器商店。再执行可取消无限模式。
- 参数: 无。
- 示例: 管理员面对一个钻石出售商店执行
/qs unlimited
,该商店将变为无限供应,不需要箱子里真正放那么多钻石;若再次执行则恢复普通库存模式。 - 返回信息: 聊天提示“Shop is now unlimited”或“Unlimited mode disabled”。
- 权限:
quickshop.unlimited
(默认OP或管理员组)。
-
/quickshop setowner <玩家名>
– 更改商店所有者。- 作用: 将一个已有商店的归属权转移给另一玩家。常用于管理员调整店主或接管遗留商店。
- 参数:
<玩家名>
新的店主玩家名。目标商店需通过面向/指向确定(一般站在店旁或用查看工具)。 - 示例: 管理员指向某商店执行
/qs setowner Alex
,此商店的店主将变为Alex。Alex 以后可管理该店(修改价格、取出收入等)。原店主失去所有权。 - 返回信息: “Shop owner changed to Alex”。若执行时未指定具体商店(没指向)会提示没有锁定商店。
- 权限:
quickshop.setowner
(默认OP)。
-
/quickshop price <价格>
– 修改商店价格。- 作用: 更改当前商店的交易价格。创建商店后若想调整售价/收购价,可用此命令。相当于重新输入一次价格。
- 参数:
<价格>
新价格数值。若商店是双向(既卖又收)可能需在GUI调整买/卖模式。 - 示例: 店主站在自己商店旁输入
/qs price 10
,则该商店的单价改为10(货币单位)。 - 返回信息: “Price for this shop is now $10 each”类似提示。
- 权限: 店主自己修改价格不需要特别权限(插件默认允许店主敲打告示牌或用命令修改)。管理员可以透过
quickshop.setowner
将店转给自己再改。
-
/quickshop buy
– 切换为收购模式。- 作用: 将商店类型改为收购(Buy模式)即商店向玩家购买物品。默认创建的商店通过玩家手持物品+shift点击决定是售卖还是收购。此命令可以强制切换。
- 参数: 无。
- 示例: 店主想把一个售出商店改为收购,则站在店旁执行
/qs buy
,告示牌会更新为收购格式,玩家可以卖东西给商店。 - 返回信息: “Shop is now buying items from players.”
- 权限: 默认店主可操作;管理员可操作任意商店需要
quickshop.other.change
之类的权限(具体节点可能没有,需通过变更店主实现)。
-
/quickshop sell
– 切换为出售模式。- 作用: 与
/qs buy
相反,将商店改为卖出物品给玩家的模式。 - 示例:
/qs sell
- 返回信息: “Shop is now selling items to players.”
- 权限: 同上。
- 作用: 与
-
/quickshop refill <数量>
– 为无限商店补货。- 作用: (若实现)为无限模式商店在日志中记录补货量。Hikari版支持Refill/Empty命令,但实际上无限商店并不需要库存物品,此命令更多用于log或触发一些事件。
- 示例:
/qs refill 64
对当前无限商店执行,会尝试在箱子放64个物品但因无限模式实际不会减少库存。 - 返回信息: 可能提示“Shop refilled by 64 items。”
- 权限:
quickshop.refill
(管理员)。
-
/quickshop empty
– 清空无限商店库存。- 作用: 与refill相对,可能用于调整无限商店显示库存为0。
- 返回信息: “Shop inventory emptied.”
- 权限:
quickshop.empty
。
-
/quickshop clean
– 清理失效商店。- 作用: 删除那些箱子不存在或告示牌被破坏的“幽灵商店”。
- 示例:
/qs clean
- 返回信息: 提示清理了多少无效商店。
- 权限:
quickshop.clean
(OP)。
-
/quickshop find <物品名称>
– 搜索附近商店。- 作用: 允许玩家搜索附近(或全服)有没有卖某种物品的商店,并指引方向。Hikari版本是否集成此功能取决配置,经典QuickShop Reremake有此功能。
- 参数:
<物品名称>
可以是材料英文名的一部分。 - 示例:
/qs find diamond
玩家执行后,插件将搜寻一定半径内销售钻石的商店,并在聊天给出最近一个的方向和距离,如“Nearest shop selling Diamond at 20 blocks north”。 - 返回信息: 找到则输出商店信息(坐标、交易类型、价格等),未找到则提示没找到。
- 权限:
quickshop.find
(默认所有玩家允许使用搜索)。
-
/quickshop preview
– 预览商品。- 作用: 打开一个物品预览界面,显示商店出售物品的详细信息(NBT、附魔等)。很多QuickShop版本在玩家右键商店时自动提供预览,此命令可能作为补充。
- 示例: 右键商店显示“输入/qs preview 确认预览物品”,玩家执行后打开物品查看界面。
- 权限: 普通玩家可用,无需额外权限。
店主无须指令的操作:
- 创建商店:玩家手持要卖的物品,左键/右键点击空箱子,即可创建商店。然后在聊天输入价格数字完成创建(插件会提示输入价格)。创建时系统会自动根据玩家点击方式决定卖出还是收购:通常shift+右键表示创建收购店,普通右键表示销售店(视版本而定)。
- 修改价格:店主可以通过破坏并重新放置告示牌或使用
/qs price
命令来调整价格。另外Hikari版本支持GUI控制面板:店主Sneak+右键点击自己的商店,可打开一个管理GUI(包含修改价格、切换buy/sell模式、添加店员等功能按钮)。 - 商店收入/库存提取:店主打开箱子即可取出卖出的收入物品或放入要出售的库存。QuickShop将玩家支付的钱存入箱子中的“交易日志”(Hikari有可能直接转入虚拟账户而无需实体货币)。
权限: QuickShop-Hikari 默认对普通玩家开放创建商店权限,但可通过quickshop.create.sell
和quickshop.create.buy
分别控制他们能否创建卖出店或收购店。quickshop.create
控制基本创建权限。quickshop.use
控制玩家能否买卖,通常所有人允许。管理员可用 quickshop.*
或OP拥有全部权限,包括管理别人的商店。
管理员功能:
- 插件会防止玩家在受保护区域创建商店(与WorldGuard联动),管理员可使用weaker权限绕过。
- 管理员可移除违规商店:直接破坏商店箱子或告示牌即可,QuickShop会检测到并删除商店数据。如果无法破坏(例如LWC锁定),可使用
/qs remove <店主>
命令(Hikari未提供这样的命令,但可通过删除箱子实现)。 - QuickShop 收到举报后,管理员可检查商店内物品(直接打开箱子)和价格,然后进行处理。
小结: QuickShop-Hikari 在玩家侧高度交互化,大部分操作无需指令,通过箱子和告示牌完成。常用指令对店主来说主要是调整价格(/qs price
)和切换模式(/qs buy/sell
)。对管理员来说,则是调整商店属性(/qs unlimited
, /qs setowner
)和维护操作(/qs clean
, /qs reload
)。插件会在聊天和告示牌上给出大量提示,引导玩家正确使用。
Residence 插件
Residence 是功能强大的领地保护插件,允许玩家自行圈地保护、分享权限、设置领地标志。指令非常丰富,这里列出主要指令:
选区与创建
-
/res select <x> <y> <z>
– 选取立方区域。- 作用: 以玩家站立点为中心,选择一个长宽高分别为
2*x+1
、2*y+1
、2*z+1
的区域作为预备领地。例如10 5 10
将选中以玩家为中心、X/Z各10格、Y轴5格的立方体范围。 - 参数:
<x> <y> <z>
各方向半径。也可使用/res select vert
选取从床岩到天空的柱体(方便高空领地)。或/res select chunk
直接选整个区块。 - 示例:
/res select 10 5 10
- 返回信息: 提示选区大小,如“Selected area: 21x11x21 (物块数...)”。
- 权限: 默认所有玩家可用基本选区命令。
- 作用: 以玩家站立点为中心,选择一个长宽高分别为
-
/res select worldedit
– 使用WorldEdit选区。- 作用: 如果安装了WorldEdit,则可用该命令直接将当前WorldEdit的两点选区转换为Residence选区。
- 示例: 先用木斧选好区域,然后
/res select worldedit
。 - 返回信息: 选区大小信息,同上。
- 权限: 需要同时有Residence和WorldEdit权限。
-
/res create <领地名>
– 创建领地。- 作用: 将当前选区保存为一个新的领地,并以给定名称命名。如果玩家未指定区域,则可用
/res create <名> <半径>
一步到位自动以玩家为圆心创建。 - 参数:
<领地名>
自定义的领地名称。同一玩家不同领地不能重名,不同玩家领地重名也许允许(取决配置)。 - 示例:
/res create Home
把刚才选择的区域创建为名为Home的领地。 - 返回信息: 成功则提示“Residence Home created。”如因尺寸或金钱等原因创建失败,会说明原因(超过允许大小或金钱不足等)。
- 权限:
residence.create
(普通玩家通常有此权限,但受限于配置里每人最大领地数、最大面积等)。
- 作用: 将当前选区保存为一个新的领地,并以给定名称命名。如果玩家未指定区域,则可用
-
/res remove <领地名>
– 删除领地。- 作用: 移除自己拥有的某个领地保护。彻底删除后,该区域将不再受Residence限制,别人可修改。
- 参数:
<领地名>
要删除的领地。 - 示例:
/res remove Home
删除名为Home的领地。 - 返回信息: 默认需要确认:会提示输入
/res confirm
确认删除(30秒内有效)。确认后输出“Residence Home removed.” - 权限: 领地所有者可以删除自己的领地。管理员可用
/resadmin remove <领地>
删除任意领地。
-
/res removeall
– 删除自己所有领地。- 作用: 一次性移除自己拥有的全部领地(危险操作)。
- 权限: 默认启用,需确认。
-
/res subzone <子区名>
– 创建子区。- 作用: 在已有领地内创建一个子区域(Subzone)用于精细权限分配。使用前需先
/res select
选好范围,领地内。 - 参数:
<子区名>
子区域名称。创建后全名为“父领地.子区名”。 - 示例:
/res subzone Farm
在当前所在领地创建名为Farm的子区域(全名如Home.Farm)。 - 返回信息: 子区创建成功提示。
- 权限: 领地所有者或在领地有子区创建权限者可用。
- 作用: 在已有领地内创建一个子区域(Subzone)用于精细权限分配。使用前需先
-
/res area add <区域ID>
– 向领地添加区域。- 作用: Residence允许一个领地包含多个不连续区域。使用该命令可将当前选区作为额外区域附加到已有领地。
- 参数:
<区域ID>
给新区域起一个ID标识(如“2”或“north”等)。 - 示例:
/res area add lake
把当前选区作为附加区域lake添加到最近的领地。添加前需进入目标领地或指定/res area add <领地> <区域ID>
完整写法。 - 返回信息: 区域添加成功则该领地保护范围扩大。
- 权限: 领地所有者可用。
-
/res confirm
– 确认操作。- 作用: 确认删除领地等需要二次确认的操作。
- 示例:
/res remove Home
后输入/res confirm
确认删除Home领地。 - 返回信息: 领地删除完成提示。
- 权限: 无特殊权限,只有在挂起confirm状态时有效。
信息与列表
-
/res list [玩家]
– 列出领地。- 作用: 不带参数列出自己拥有的领地名称;带玩家参数则列出该玩家的领地列表(需要查看他人权限)。
- 示例:
/res list
-> “Your residences: Home, Mine, Shop”;/res list Steve
-> “Steve's residences: Castle, Farm”。 - 权限: 自己的领地可查,
residence.list.other
允许查别人。
-
/res current
– 显示当前位置所属领地。- 作用: 告诉玩家当前位置处于哪个领地内部(包括子区)。
- 示例: 玩家走到某地执行
/res current
,可能返回“You are in residence: SteveCastle.Floor2”。如果没在任何领地则提示“Wilderness”或无领地。 - 权限: 所有人可用。
-
/res info [领地名]
– 查看领地信息。- 作用: 显示指定领地的详情,包括:所有者、大小、位置坐标范围、租售信息、flags设置、trusted玩家列表等。若不指定领地则默认查看脚下所在领地。
- 参数:
[领地名]
可选,如果未处于领地内,可手动指定领地全名。 - 示例:
/res info Home
列出自己Home领地信息;在领地中输入/res info
则列出所在领地的信息。 - 返回信息: 例如:
Residence Name: Home Owner: Alex Size: 50x256x50 (blocks: 2500) Flags: firespread=false, monsters=false, ... Trusted: Bob (build), Charlie (use) ...
- 权限: 领地内玩家默认可查看,查看他人领地需要
residence.admin
权限或该领地的访客权限。
-
/res show
– 显示领地边界。- 作用: 以临时可视化方式显示当前所在的领地范围边界(例如用粒子、光标等标示)。有助于肉眼确认领地边界。
- 参数: 无。
- 示例:
/res show
将在玩家周围地面四角生成火焰/粒子,标明领地边缘(持续几秒)。 - 权限: 所有人可用自己领地或当前所在领地的显示。
-
/res listall
– 列出服务器所有领地。- 作用: 以分页形式列出全服已存在的所有领地名称及所属玩家。
- 示例:
/res listall
可能输出:“1. Alex: Home, Mine; 2. Bob: City, Farm; ...” - 权限:
residence.list.all
(默认OP)。
-
/res sublist [领地]
– 列出领地的子区。- 作用: 显示指定领地下定义的所有子区域名称。
- 示例:
/res sublist Home
-> “Subzones of Home: Home.Farm, Home.House, ...” - 权限: 领地拥有者或管理员。
-
/res version
– Residence 插件版本。- 作用: 显示Residence插件版本信息。
- 权限: 所有人可用(无敏感信息)。
权限与Flag设置
-
/res padd <玩家>
– 添加玩家信任。- 作用: 将一个玩家添加为当前领地的信任成员,相当于赋予默认访问权限集(通常至少build和use)。等价于对多个flag赋权的快捷。
- 参数:
<玩家>
被添加的玩家名。 - 示例:
/res padd Bob
让Bob成为当前领地成员,可以自由进入、建造等(具体权限由配置的Member组默认flags决定)。 - 返回信息: “Bob has been added to residence.”
- 权限: 领地所有者。
-
/res pdel <玩家>
– 移除玩家权限。- 作用: 取消前面通过
/res padd
或pset赋予的玩家权限,将其从领地信任名单移除。 - 参数:
<玩家>
名字。 - 示例:
/res pdel Bob
把Bob移出领地,不再有权限。 - 返回信息: “Bob has been removed from residence.”
- 权限: 领地所有者。
- 作用: 取消前面通过
-
/res set <flag> <true|false|remove>
– 设置领地Flag。- 作用: 设置当前领地的一个Flag开关。Flag表示领地中的行为准许/禁止,例如build(建造方块),use(使用门/按钮),monsters(怪物生成)等。
- 参数:
<flag>
Flag名称;<true/false/remove>
开启、关闭或重置为默认。 - 示例:
/res set monsters false
禁止该领地刷怪;/res set firespread false
禁止火焰蔓延。 - 返回信息: “Flag set to false.”
- 权限: 领地所有者可改大部分flag,但某些全局性flag只有管理员能改(如tnt,lavaflow等)。管理员可通过
/resadmin set
覆盖所有者限制。
-
/res pset <玩家> <flag> <true|false|remove>
– 为特定玩家设置权限。- 作用: 针对领地内某个玩家单独设置Flag权限,与
/res set
不同,它只影响特定玩家。用于自定义某人能做但其他人不能的情况。 - 参数:
<玩家>
目标玩家;<flag>
要设置的权限;<状态>
开启/关闭/移除。 - 示例:
/res pset Charlie build true
允许玩家Charlie在领地建造,即使其他非信任玩家不能建造。 - 返回信息: “Player Charlie now has build = true in this residence.”
- 权限: 领地所有者可用。管理员可对任意玩家设置任何领地flag(通过
/resadmin pset
)。
- 作用: 针对领地内某个玩家单独设置Flag权限,与
-
/res gset <组名> <flag> <状态>
– 设置群组权限。- 作用: Residence可以自定义权限组(friends, allies等)给予一组玩家相似权限。此命令可在领地级别调整某组默认flag。
- 示例:
/res gset friends use true
允许“朋友”组玩家在此领地使用按钮/门。 - 权限: 领地所有者。
-
/res check <领地> <flag> [玩家]
– 检查flag状态。- 作用: 查看某flag对特定玩家是否有效(考虑pset、gset、全局等所有层次后的结果)。
- 示例:
/res check Home build Bob
查看Bob在Home领地是否有build权限。如果Bob是owner则肯定true,如果只是访客可能false。 - 返回信息: “Flag build for Bob: false (denied by default group setting)”类似详细原因说明。
- 权限: 领地owner或管理员。
-
/res flags
– 列出可用Flags。- 作用: 列出所有Residence支持的flag名称及含义。
- 返回信息: 旗标列表,如“build – allow building; use – allow use of buttons; monsters – allow monster spawn; ...”。
- 权限: 所有人可用查看。
-
/res default <领地>
– 恢复默认Flags。- 作用: 将目标领地的所有flag恢复为服务器默认设置。
- 示例:
/res default Home
重置Home领地flag为默认值(monsters重新允许等等)。 - 返回信息: 确认flag已重置。
- 权限: 领地owner。
-
/res setmain
– 设为主领地。- 作用: 如果玩家有多个领地,此命令可将一个标记为“主领地”,通常在聊天或其他地方作为玩家领地前缀显示。
- 示例:
/res setmain Home
将Home设为自己的主领地。可能在聊天显示如“[Home]玩家: 你好”。 - 权限: 所有人可用。
传送 & 租赁
-
/res tp <领地>
– 传送到领地。- 作用: 将自己传送到指定领地的设置的传送点(默认为领地中心或创建时的位置,可通过
/res tpset
更改)。 - 参数:
<领地>
可以写玩家名:领地
访问他人公开领地,或自己的直接写名称。 - 示例:
/res tp Steve:Shop
传送到Steve的Shop领地(前提是开放传送或自己有权限)。 - 返回信息: 若开放则立即传送并提示“Teleported to Shop”。若无权限或未公开则提示拒绝。
- 权限:
residence.tp
玩家自身领地传送,residence.tp.other
传送到他人领地。
- 作用: 将自己传送到指定领地的设置的传送点(默认为领地中心或创建时的位置,可通过
-
/res tpset
– 设置领地传送点。- 作用: 将当前所在位置设为本领地下次
/res tp
来的落点。默认创建领地时spawn点就是创建者位置,但可调整。 - 示例: 站在希望位置执行
/res tpset
,以后传送就到这来。 - 返回信息: “Teleport location set.”
- 权限: 领地owner(
residence.tpset
)。
- 作用: 将当前所在位置设为本领地下次
-
/res rt [世界] [玩家]
– 随机传送。- 作用: 若启用Residence的随机传送功能,则
/res rt
可以将玩家随机传送到某世界的安全地点(通常野外无人地区)。 - 参数:
[世界]
不填则当前世界;[玩家]
管理员可指定玩家随机传送。 - 示例:
/res rt
自己随机传送,/res rt nether Steve
将Steve随机扔到下界某处。 - 权限:
residence.rt
自己用,residence.rt.others
传送他人。
- 作用: 若启用Residence的随机传送功能,则
-
/res market
– 房产市场浏览。 (如果启用了领地租售市场)- 作用: 打开领地买卖GUI或列表。列出玩家挂牌出售或出租的领地及价格。玩家可点击购买或租赁。
- 权限: 默认所有玩家可用市场功能。
-
/res sell <价格>
– 挂牌出售领地。- 作用: 将自己的领地以指定价格挂牌出售给其他玩家。对方可用
/res buy <领地>
购买。 - 示例:
/res sell 5000
将当前领地以5000货币挂牌。 - 权限: 领地owner,且需要启用经济和市场子功能。
- 作用: 将自己的领地以指定价格挂牌出售给其他玩家。对方可用
-
/res buy <领地>
– 购买领地。- 作用: 购买指定正在出售的领地,扣除金额并转移所有权。
- 示例:
/res buy Steve:Shop
购买Steve出售的Shop领地(自己需有足够余额)。 - 权限: 默认允许,需经济支持。
-
/res lease <价格> <天数>
– 出租领地。- 作用: 将领地按天出租,每
<天数>
自动扣费<价格>
,租期结束回收。 - 参数: 价格和周期。
- 示例:
/res lease 100 7
每7天100货币出租当前领地。 - 权限: owner。
- 作用: 将领地按天出租,每
-
/res lease rent <领地>
– 租下领地。- 作用: 租用一个挂牌出租的领地。
- 权限: 默认开放。
管理员命令 (ResAdmin)
Residence 提供/resadmin
前缀来以管理员身份执行,无视领地所有权限制。管理员可以修改/删除他人领地、设置全局Flag等:
/resadmin remove <领地>
– 强制删除领地。/resadmin set/pset ...
– 管理员版设置flag(对任意领地/玩家)。/resadmin override
– 切换管理模式。开启后管理员将无视领地保护,可自由破坏/进入任何领地(相当于给予自己所有领地的OP权限)。再执行关闭。/resadmin list
– 列出所有领地(等价/res listall)。/resadmin version
– 查看Residence版本(等价/res version)。
管理员还有一些调试指令例如:
/resadmin backup
– 备份领地数据/resadmin restore <文件>
– 从备份恢复领地数据/resadmin purge <玩家>
– 删除某玩家所有领地(用于清理不再上线玩家的数据)/resadmin reload
– 重载Residence配置
权限: 绝大多数ResAdmin命令需要residence.admin
权限,通常赋予OP或管理员组。
Residence 插件的指令体系较庞大,上述只涵盖其中核心部分。通过Residence,玩家可以方便地保护财产并管理地皮权限;管理员可以灵活控制世界规则(如禁用某世界领地PVP等,通过全局flags设置)。建议管理员在使用前熟悉Residence配置文件,里面定义了各项默认值(如每人最大领地数、领地最大大小、租赁费率等)。合理使用Residence能大大减少纠纷,保障玩家建筑安全。
Shop 插件
(假设此“Shop”指的是一个GUI商店插件,例如 EconomyShopGUI 或 RandomShop。如与 QuickShop 不同,Shop 插件通常提供服务器商品交易GUI,以下按一般GUI商店插件说明)
Shop 插件提供服务器自定义的商品菜单,玩家可通过命令打开商店界面购买物品,或卖出物品给服务器。主要指令:
-
/shop
– 打开主商店菜单。- 作用: 打开服务器主商店GUI界面,列出可购买的物品分类或直接列出商品。
- 参数: 无(有的插件
/shop <分类>
可直接打开特定分类)。 - 示例: 玩家输入
/shop
,屏幕出现一个带有多个物品图标的界面,每个代表可购买的道具或一个分类入口(比如“建筑方块”、“矿物”、“食物”等)。点击分类可深入,点击具体物品会弹出购买数量选择或确认窗口。 - 返回信息: 无聊天输出,直接GUI交互。
- 权限: 通常所有玩家都有
shop.use
权限。若有分类权限限制,可能需要如shop.category.tools
才能见某分类。
-
/shop sellhand
或/sellhand
– 出售手上物品。- 作用: 快捷地将当前手持的物品按商店设定价格卖给服务器。
- 参数: 无。(有的插件此命令和Essentials重复,需要通过配置alias使用)
- 示例: 手持64个铁锭执行
/shop sellhand
,如果商店配置铁锭单价5元,则卖出后获得5*64=320元,物品从背包移除。 - 返回信息: “Sold 64 Iron Ingot for $320.”
- 权限:
shop.sell
或与物品相关的出售权限(视插件,若无特殊限制默认允许出售商店收购的所有物品)。
-
/shop sellall
– 出售背包所有可卖物品。- 作用: 将背包中所有商店收购的物品一次性卖掉。
- 示例:
/shop sellall
卖出背包中所有钻石、铁锭等在商店有回收价的物品。 - 返回信息: 列出卖出的物品种类和收益总和。
- 权限: 同上
shop.sell
.
-
/shop search <物品名>
– 搜索商品。- 作用: 在商店商品列表中查找包含关键字的物品及其价格。方便玩家知道某物品能否在商店买到/卖出。
- 参数:
<物品名>
关键字,可为部分名称。 - 示例:
/shop search diamond
返回“Diamond: Buy $100, Sell $80”表示钻石可以100买80卖。 - 权限:
shop.search
。
-
/shop add <物品> <买价> [卖价]
– 添加商店商品(管理员)。- 作用: 快速添加一个商品到商店列表,设定购买价格和可选的回收价格。可能需要同时指定分类。
- 示例:
/shop add minecraft:apple 10 5
将苹果加入商店,卖价10,收购价5。 - 返回信息: 确认商品已添加。如果插件要求从GUI配置,则可能无此命令。
- 权限:
shop.admin
。
-
/shop reload
– 重载Shop配置。- 作用: 重新加载Shop插件的配置文件和商品列表数据。
- 示例:
/shop reload
- 返回信息: “Shop config reloaded.”
- 权限:
shop.admin
或 OP。
-
/shop del <物品>
– 删除商店商品(管理员)。- 作用: 将指定物品从商店移除,不再可买卖。
- 示例:
/shop del apple
- 返回信息: “Removed Apple from shop.”
- 权限:
shop.admin
。
(注意: 具体指令名称和用法可能因插件不同而异。例如EconomyShopGUI的主命令是/es
, /shop
是别名。而RandomShop通过/shop
GUI管理,配置不提供add命令。以上是通用示例。)
权限:
shop.use
– 打开商店权限。shop.buy.<物品>
/shop.sell.<物品>
– 针对单个物品购买/出售权限控制,有些插件可以细分权限到物品。shop.category.<分类>
– 控制玩家是否能看到某分类。- 管理权限
shop.admin
– 允许使用添加删除商品、重载等指令。
使用流程: 玩家通常只需要/shop
打开菜单,点击想买的物品,然后在弹出的数量选择界面点击+/-选择数量,最后确认购买。若是卖出,通常点击“出售”标签或在/shop
菜单切换到回收模式,然后选择要卖的物品。也有些插件提供独立命令/sellgui
。
后台配置: 管理员通常通过配置文件添加商品及定价,或使用图形编辑模式(部分插件支持在游戏内以GUI编辑商品)。命令行添加/删除适合临时调整。
Vault 插件
Vault 是一个经济/权限/聊天接口插件,本身并无直接功能,但提供了两个管理命令主要供管理员查看配置:
-
/vault-info
– 显示 Vault 挂钩信息。- 作用: 列出当前服务器上Vault检测到的经济插件、权限插件、聊天格式插件。方便确认Vault正确连接了哪个插件。
- 参数: 无。
- 示例:
/vault-info
在聊天输出:
这表示Vault目前使用EssentialsX Economy作为经济接口,LuckPerms作为权限接口,没有聊天插件接入。[Vault] Economy: EssentialsEco (enabled) [Vault] Permissions: LuckPerms (enabled) [Vault] Chat: None
- 返回信息: 如上所示,各系统对应的已挂接插件。如果某项显示“None (inactive)”则表示没找到相应插件。
- 权限:
vault.admin
(默认OP可用)。
-
/vault-convert <源经济> <目标经济>
– 转换经济数据。- 作用: 将玩家余额数据从一个经济插件迁移到另一个。仅在你更换经济插件时使用(极少用)。
- 参数:
<源经济>
<目标经济>
例如EssentialsEconomy
和iConomy
等。 - 示例:
/vault-convert EssentialsEconomy iConomy
将EssentialsX经济余额导入iConomy数据库。 - 返回信息: 会提示转换进度或结果(视实现,有些Vault版本可能不直接实现转换功能,需要各插件自带)。
- 权限:
vault.admin
。
Vault 没有其他玩家命令,普通玩家无需关心Vault。
功能解析: Vault 本质是个API,不存储数据。/vault-info
有助于确认Vault是否正确识别了您安装的经济/权限系统。例如安装Vault后执行此命令,若显示Economy: None,则意味着您还未安装任何经济插件(如 EssentialsX、CMI Economy 等),一些需要经济的插件可能无法工作。这个命令对排查经济或权限相关问题很有用。
小提示: 若在服务器控制台看到Vault错误,大多表示它没找到需要的插件。Vault自身无需配置,安装即可。只有在涉及数据迁移时可能用到/vault-convert
(例如从旧经济插件换到新插件时,希望保留玩家余额)。但进行此操作前请务必备份数据。
ViaVersion 插件
ViaVersion 允许不同版本客户端连接服务器,是兼容性插件。ViaVersion 提供几个管理命令帮助检查版本连接情况或配置:
-
/viaversion
或/vv
,/via
– ViaVersion 主命令。- 作用: 不带参数时,显示ViaVersion插件版本和可用子命令帮助。
- 返回信息: 例如:
ViaVersion 4.3.1 running on Paper 1.18.2 Sub-Commands: autoteam, dontbugme, list, reload Use /viaversion <sub> for details.
- 权限: 默认OP。
-
/viaversion list
– 列出在线玩家协议版本。- 作用: 显示当前所有在线玩家及其所使用的客户端Minecraft版本。这对于了解有哪些不同版本的玩家在服务器很有用。
- 参数: 无。
- 示例:
/via list
输出:Online players and their client versions: Steve - 1.19.4, Alex - 1.18.2, Bob - 1.20.1
- 返回信息: 每个玩家对应一个客户端版本。
- 权限:
viaversion.admin
(默认OP)。
-
/viaversion autoteam
– 切换自动队伍优化。- 作用: ViaVersion提供修复1.8 PVP队伍BUG的“AutoTeam”功能。此命令开关自动队伍,以防止1.9+的碰撞关闭造成的队伍影响。若您遇到玩家莫名同队的问题,可尝试关闭autoteam。
- 参数: 无。
- 示例:
/via autoteam
切换状态。如果当前启用则执行后关闭,反之打开。 - 返回信息: “Auto Team now: false/true”。
- 权限:
viaversion.admin
。
-
/viaversion dontbugme
– 关闭更新提醒。- 作用: ViaVersion会在有新版本时提醒OP。执行此命令可关闭你的登录提醒(对执行者有效,不影响他人)。
- 参数: 无。
- 示例: OP登录被ViaVersion提醒更新,此时输入
/via dontbugme
后,今后这个提醒将不再出现给你。 - 返回信息: “ViaVersion will not bug you about updates.”
- 权限:
viaversion.admin
。
-
/viaversion reload
– 重载配置。- 作用: 重新加载ViaVersion的配置文件(viaversion.yml)。用于实时应用配置更改,无需重启。
- 参数: 无。
- 示例: 更改了协议兼容设置后执行
/via reload
。 - 返回信息: “ViaVersion configuration reloaded.”
- 权限:
viaversion.admin
。
ViaBackwards & ViaRewind: ViaVersion 组合使用ViaBackwards和ViaRewind可以允许更低版本客户端加入(例如1.16服务器让1.12客户端进)。ViaBackwards和ViaRewind没有单独命令,都由ViaVersion统一管理。因此/via list
会同时列出低版本玩家,不需要额外命令。ViaBackwards配置项也在viaversion.yml里,同通过/via reload
重载。
应用示例:
- 管理员怀疑某玩家因为版本原因无法进服,则可以
/via list
看看已有玩家的版本分布,确认插件工作正常(若大部分玩家1.19,就表示1.19可进,若出问题玩家是1.20可能服务端未支持1.20)。 - 如果开启了1.8碰撞规则兼容,在Tab列表中会看到所有玩家自动进一个Team(ViaVersion AutoTeam实现),如果不想要这种效果可
/via autoteam
关闭,但可能导致1.9客户端玩家在1.8服出现PVP碰撞问题。 /via dontbugme
纯粹是个人偏好命令,不影响服务器功能,仅用于关闭版本更新提示,可根据需要使用。
权限: ViaVersion命令大多需要viaversion.admin
,默认OP具备。普通玩家不需要用ViaVersion命令。
ViaBackwards 插件
ViaBackwards 是 ViaVersion 的附属插件,使服务端支持更旧版本客户端连接(它负责1.12-1.9和1.13-1.8之间数据转换等)。ViaBackwards 本身没有独立指令。它的配置集成在ViaVersion中,安装后ViaVersion自动调用它进行兼容处理。
- 指令: 无专门指令。一切通过ViaVersion完成。ViaBackwards不会输出独立信息。
- 权限: 无需额外权限。ViaBackwards和ViaRewind启动后,
/viaversion list
即可看到低版本客户端,并自动处理翻译。
因此,管理员不需要直接操作ViaBackwards。当有更新时,只需像更新ViaVersion那样更新插件即可。ViaBackwards的作用是被动的。