Skip to content

Latest commit

 

History

History
71 lines (49 loc) · 3.53 KB

README.md

File metadata and controls

71 lines (49 loc) · 3.53 KB

Noxesium

A fabric mod centered around improving the user experience when playing on multiplayer servers.

Server developers are welcome to submit additional patches they need, feel free to open an Issue to discuss your ideas.

Usage

Public builds of Noxesium can be found on the Modrinth page. Upcoming releases can be found on the Releases page here on GitHub.

Developers that want to use Noxesium as a dependency can add it can find the artefact on our public Maven repository.

<repository>
    <id>noxcrew-maven</id>
    <name>Noxcrew Public Maven Repository</name>
    <url>https://maven.noxcrew.com/public</url>
</repository>

<dependency>
  <groupId>com.noxcrew.noxesium</groupId>
  <artifactId>api</artifactId>
  <version>REPLACE_WITH_CURRENT_NOXESIUM_VERSION</version>
</dependency>

Features

Additions

Noxesium provides various additional features focussed around giving servers more control over how the client behaves. Some examples of additional things servers can do:

  • Create custom interactables on the client like speed boosters or jump pads
  • Draw player heads in text messages
  • Play custom sounds and control various properties, including a start offset, changing the volume over time, resuming playing the sound and starting anchored to a UNIX timestamp
  • Tweak the behavior of riptide tridents to make them more usable in multiplayer games
  • Prevent moving items in GUIs
  • Locking camera movement

There are also a few improvements that do not require a server:

  • Prevents toggle sprint/sneak from resetting on death (can be configured)
  • Allow rendering off-hand maps as a UI element
  • Adds toggleable debug features for server and shader developers

Performance

Noxesium contains a performance patch which reworks UI rendering to have a dynamic fps. Instead of rendering the UI every frame it gets rendered between 20 and 60 times a second. Whenever a UI element changes it starts getting rendered at 60 fps, while UI elements that rarely change render at 20 fps. These are currently experimental and have to manually be enabled in the Noxesium configuration screen.

Bugfixes

Noxesium also fixes various small client bugs that relate to multiplayer servers.

  • Fixes jittery behavior of teleporting entities on mounts
  • Fixes lighting issues with moving piston walls
  • Music properly resumes playing when setting the volume to 0% and back up
  • Fixes the backgrounds of text displays not being transparent

MCC Island-specific Features

There are also a few features specific to MCC Island as Noxesium is developed alongside it:

  • Adds a setting to show player heads in UIs
  • Provides access to additional information sent by the server regarding the current server and current game state

For developers

Any developers interested in writing code that interacts with Noxesium should have a look at the api module which contains various structures useful for setting up a server-side implementation that interacts with Noxesium. This modules does not have a dependency on fabric and can thus be used as a dependency in server software.

We also provide the paper module which contains our own server-side implementation written in Kotlin which allows you to interface with Noxesium clients. This also implements backwards compatibility for older Noxesium clients.

Further information about specific features of the mod can be found on the Wiki page.