NoxesiumUtils

插件

· 作者 SuperNeon4ik

轻松与 Noxesium 模组进行交互。

0 本站下载 0 关注 更新于 2 年前

需要前置:CommandAPI

最新 2.0.0 · 1.21.1 · Paper / Purpur

一键开服(送7天)

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 上查看

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源