NoxesiumUtils
轻松与 Noxesium Mod 进行通信。
?? Made in Ukraine! Зроблено в Україні!
❤️ Support me on Patreon
With NoxesiumUtils 2.0.0 I am switching to the com.noxcrew.noxesium.paper implementation, instead of my own. This makes maintaining NoxesiumUtils easier.
What is Noxesium and why does it need Utils?
Noxesium Mod (by Noxcrew) is a fabric mod with feature additions, bugfixes, and performance improvements. It allows servers to offer a better experience to clients through access to additional features beyond vanilla limitations. However, servers need to have a plugin to communicate with the mod to actually be able to use it's features, and that's where NoxesiumUtils comes in. It allows server owners to easily communicate with the mod via commands and can also be used as a dependency for plugin developers.
Features
- Send server rules on join
- Send server rules to players with commands
- Check player's client settings.
- There is a little more to it, lol.
- Maybe more soon ?
Requirements
- Paper 1.20+
- CommandAPI
- The plugin won't do anything to players without the mod
Commands
Send Server Rule. Sends a server rule to a selection of players.
Set server rule for players
/noxesiumutils serverrule <rule> <players: selector> <value>
/noxesiumutils serverrule <rule> <players: selector> reset
Set entity rule for entities
/noxesiumutils entityrule <rule> <entities: selector> <value>
/noxesiumutils entityrule <rule> <entities: selector> reset
Check player's Noxesium Protocol Version.
/noxesiumutils check <player: player>
/noxesiumutils check <players: selector>
Check player's settings.
/noxesiumutils clientSettings <player: player>
For more detailed information on how everything here works, please refer to the Noxesium Mod README!
Config
The default config looks like this. Right now it only contains a setting to send server rules to a player on join.
# View Protocol documentation and information about the mod here:
# https://github.com/Noxcrew/noxesium
# Add some extra output for debugging purposes
extraDebugOutput: false
# If true will check the plugin's version once in a while.
checkForUpdates: true
# It true will send defaults to Noxesium Players on join.
sendDefaultsOnJoin: false
# Comment out the line if you don't want to send that rule.
defaults:
#cameraLocked: false
#disableBoatCollisions: false
#disableDeferredChunkUpdates: false
#disableMapUi: false
#disableSpinAttackCollisions: false
#disableUiOptimizations: false
#disableVanillaMusic: false
#enableSmootherClientTrident: false
#heldItemNameOffset: 0
#overrideGraphicsMode: FAST
#riptideCoyoteTime: 0
#showMapInUi: false
#qibDefinitions:
#customCreativeItems: []
On-join defaults
For example, the following changes will make the plugin automatically send
the players disableSpinAttackCollisions = true on join.
sendDefaultsOnJoin: true
defaults:
disableSpinAttackCollisions: true
Qib definitions
What are Qibs? Good question. I won't explain it perfectly, so please read the comments in this file in Noxcrew/noxesium.
The qibDefinitions list is a place to define the definitions which are made up of QibEffects (see list of them here).
Here's an example of a QibDefinition in the config:
qibDefinitions:
ding:
onEnter: 'play_ding'
onLeave: 'play_ding'
triggerEnterLeaveOnSwitch: false
Now scary part: writing QibEffects.
Each QibEffect is saved in its own json file which is saved in plugins/NoxesiumUtils/qibs folder.
Example of a QibEffect which plays the ding sound (plugins/NoxesiumUtils/qibs/play_ding.json):
{
"type": "PlaySound",
"effect": {
"namespace": "minecraft",
"path": "entity.experience_orb.pickup",
"volume": 1.0,
"pitch": 1.0
}
}
(probably very useful to some) A jumppad QibEffect example:
{
"type": "Multiple",
"effect": {
"effects": [
{
"type": "PlaySound",
"effect": {
"namespace": "minecraft",
"path": "entity.experience_orb.pickup",
"volume": 1.0,
"pitch": 1.0
}
},
{
"type": "Wait",
"effect": {
"ticks": 1,
"effect": {
"type": "SetVelocityYawPitch",
"effect": {
"yaw": 0,
"yawRelative": true,
"pitch": -45,
"pitchRelative": false,
"strength": 2.0,
"limit": 2.5
}
}
}
}
]
}
}
After making a QibEffect you use the file name of a QibEffect as an ID in a QibDefinition section (all fields are optional):
qibDefinitions:
ding:
onEnter: 'QIB_EFFECT_ID'
onLeave: 'QIB_EFFECT_ID'
whileInside: 'QIB_EFFECT_ID'
onJump: 'QIB_EFFECT_ID'
triggerEnterLeaveOnSwitch: false
之后,你可以重新加载服务器并将规则应用于某个实体:
/noxesiumutils entityRules qibBehavior [ENTITY] ding
并为所有玩家启用 Qib:
/noxesiumutils serverRules qibBehaviors @a ding
自定义创造模式物品
你可以通过命令(/noxesiumutils serverRules customCreativeItems @a true)为 Noxesium 玩家在创造模式物品栏菜单中启用一个标签页。这是定义这些物品的地方。以下是一个示例:
customCreativeItems:
- 'minecraft:stick[minecraft:enchantments={levels:{"minecraft:knockback":25}}]'
- 'netherite_chestplate[trim={pattern:wild,material:emerald},custom_name=''["",{"text":"Silly name ngl","italic":false}]'',lore=[''["",{"text":"I dont !!!!!!! understand how i will implement this","italic":false}]''],enchantments={levels:{aqua_affinity:1,blast_protection:4,protection:5}},custom_model_data=2]'
对于开发者
在 GitHub 上查看
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧