描述
Ultimate Weapons 为 Minecraft 1.21.4+ 引入了强大且高度可自定义的物品,其设计灵感主要来自各大 Minecraft 服务器(尤其是 Hypixel),并通过避免使用 tick 函数来力求将对性能的影响降至最低。
使用方法
获取物品
要获取 UWS 物品,只需运行以下命令:
/function uws:get_item/<item_name>
目前共有 14 种可用物品,未来更新还将推出更多独特物品。所有物品现在只能通过命令获取,以便让服务器管理员完全掌控物品的分发与使用方式,从而在不通过预设配方直接影响机制的前提下,灵活适应游戏玩法。
有关所有 UWS 物品的文档,请访问 此页面。
自定义物品 / 效果
UWS 物品由 UWS 效果驱动,这些效果是可自定义且独立的,意味着效果并不绑定于特定物品,你可以完全控制其应用方式,从而实现将任意数量的效果叠加到同一物品上的功能。这些效果通常通过附魔、进度或 consumable 组件触发。每个 UWS 物品都关联一个独特的 UWS 效果。有关所有 UWS 效果的完整文档,请访问 此页面。
若要自定义 UWS 物品 / 效果,首先请使用以下命令:
/function uws:get_item_config/<item_name>
这将给予你两个命名分别为 <item_name> Template 和 <item_name> Modifier 的命令方块。<item_name> Template 方块负责为你提供 UWS 物品,同时允许你通过编辑其参数来调整其效果;而 <item_name> Modifier 则允许你修改手中物品的效果。
- 在 Template 方块中: 在此方块内,查找以下数据:
"minecraft:custom_data":"{uws_effects:{<effect_name>:{key1:value,key2:value,...}}}"
<effect_name> 指的是将应用于此物品的效果;在此情况下,即为与该 UWS 物品关联的效果。你可以通过编辑对象中特定字段的 value 来自定义它。效果字段及其详细信息的完整列表可在 wiki 上找到。
编辑完成后,激活该命令方块以接收目标 UWS 物品的自定义版本。
- 在 Modifier 方块中: 在此方块内,查找以下数据:
"minecraft:set_custom_data","tag":"{uws_effects:{<effect_name>:{key1:value,key2:value,...}}}"
这与上述类似。修改对象中给定字段的 value,然后激活它以将更改应用于手中物品的效果。这也能确保物品获得触发效果所需的触发器。
[注意]
只有当效果的所有参数完整且格式正确时,自定义才会生效。缺少或格式不正确的参数可能导致在触发效果时所有值回退至默认值。
将效果应用于其他物品
若要将 UWS 效果应用于你的手持物品,请使用以下命令:
/function uws:set_effect/<effect_name>
如果你不确定哪个效果对应哪个物品,请使用以下命令查看你手中物品的效果信息:
/function uws:help/lookup_held_item
管理效果
禁用 UWS 效果:
/function uws:ban_effect/<effect_name>
这将阻止该效果被触发。对于可消耗的物品或方块,这也取消了它们的放置或消耗。
解除禁用 UWS 效果或清除禁用列表:
/function uws:unban_effect/<effect_name>
/function uws:unban_effect/all
调整偏好设置
无论你是否拥有权限,都可以使用此命令查看可用选项并调整语言、冷却显示等设置:
/trigger uws_options
在命令末尾添加 set <number> 以定位特定选项。
注意事项
- Ultimate Weapons 需要持续存在的实体和强制加载的区块才能正常运行。请避免杀死所有实体(请改用
/kill @e[tag=!uws.persistent])或删除主世界中的所有强制加载区块。
- Ultimate Weapons 会覆盖原版战利品表以实现某些高级功能,因此建议确保与其他数据包无冲突。
- 如果你需要卸载该数据包,可以使用
/function uws:unload 移除它留下的所有痕迹(不包括玩家数据库)。
支持的语言
Ultimate Weapons 支持以下语言(涵盖文本消息和 UWS 物品名称下方的文字说明):
- English
- Simplified Chinese
- Cantonese (Hong Kong)
切换语言
设置默认语言:
/function uws:language/default/<lang>
设置你偏好的语言:
/function uws:language/prefer/<lang>
切换后,物品名称下方的文字说明的语言可能不会立即更新。
Description
Ultimate Weapons introduces powerful and highly customizable items for Minecraft 1.21.4+ that draws inspiration from major Minecraft servers, especially Hypixel, and aims to minimize performance impact by avoiding the use of tick functions.
How to use
Get item
To obtain an UWS item, simply run this command:
/function uws:get_item/<item_name>
Currently, there are 14 available items, and more unique ones will be coming in future updates. All items are now only obtainable through commands, so as to give server admins full control over how items are distributed and utilized, allowing for flexible adaptation to gameplay without directly affecting mechanics through predefined recipes.
For the documentation of all UWS items, visit this page.
Customize item / effect
UWS items are driven by UWS effects that are customizable and independent, meaning the effects are not bound to a specific item and you have full control over their application, making things possible like stacking as many effects as you like onto an item. These effects are usually triggered through enchantments, advancements, or consumable components. Each UWS item is associated with a unique UWS effect. Visit this page for the full documentation of all UWS effects.
To customize an UWS item / effect, first use this command:
/function uws:get_item_config/<item_name>
This will give you two command blocks with name <item_name> Template and <item_name> Modifier. The <item_name> Template block is responsible for giving you an UWS item whilst allowing you to tweak its effects by editing its arguments, while the <item_name> Modifier lets you modify the effects of your held item.
- In Template block: Inside this block, look for this data:
"minecraft:custom_data":"{uws_effects:{<effect_name>:{key1:value,key2:value,...}}}"
The <effect_name> refers to the effect that will apply to this item; in this case, it is the effect that the UWS item is associated with. You can customize it by editing the value of specific fields in the object. A complete list of effect fields and their details can be found on the wiki.
Once you've finished editing, activate the command block to receive the customized version of the target UWS item.
- In Modifier block: Inside this block, look for the this data:
"minecraft:set_custom_data","tag":"{uws_effects:{<effect_name>:{key1:value,key2:value,...}}}"
This is similar to above. Modify the value of a given field in the object, then activate it to apply the changes to your held item's effect. This also ensures the item gains the necessary trigger to activate the effect.
[NOTE]
Customization will only work if all arguments of the effect are complete and correctly formatted. Missing or incorrectly formatted arguments could result in all values falling back to their default ones when triggering the effect.
Apply effect to other item
To apply an UWS effect to your held item, use the command below:
/function uws:set_effect/<effect_name>
If you're not sure which effect is associated with which item, use this command to get the effect info of your held item:
/function uws:help/lookup_held_item
Manage effects
Ban an UWS effect:
/function uws:ban_effect/<effect_name>
This will prevent the effect from being triggered. For blocks or items that are consumable, this also cancels their placement or consumption.
Unban an UWS effect or clear banlist:
/function uws:unban_effect/<effect_name>
/function uws:unban_effect/all
Adjust your preferences
Whether or not you have permission, you can use this command to view available options and adjust settings such as language, cooldown displays, and more:
/trigger uws_options
Add set <number> at the end of the command to target a specific option.
Notes
- Ultimate Weapons requires a persistent entity and a forceloaded chunk to function properly. Please avoid killing all entities (use
/kill @e[tag=!uws.persistent] instead) or removing all forceloaded chunks in the overworld.
- Ultimate Weapons overrides vanilla loot tables to implement some advanced features, so it's advisable to ensure there are no conflicts with other packs.
- If you need to uninstall the datapack, you can use
/function uws:unload to remove all traces left by it (player database not included).
Supported languages
Ultimate Weapons supports the following languages (covering text messages and UWS item lores):
- English
- Simplified Chinese
- Cantonese (Hong Kong)
Switch language
Set default language:
/function uws:language/default/<lang>
Set your preferred language:
/function uws:language/prefer/<lang>
*The language for item lores may not update immediately after switching.
评论 0
登录后参与评分
还没有评论,来抢沙发吧