Go to file
Chimney Swift 69a40e58e7 Add ability to control online players along with max players 2020-07-01 01:13:05 +10:00
.circleci Add CircleCI 2020-01-18 10:08:16 -06:00
gradle/wrapper Update to Gradle 5.1.1 2019-01-25 21:05:01 -06:00
src/main Add ability to control online players along with max players 2020-07-01 01:13:05 +10:00
.gitignore Add .idea/ directory to .gitignore 2019-04-21 11:13:06 +01:00
.travis.yml Attempt to fix Travis builds v2 2019-01-24 17:59:35 -06:00
LICENSE Update LICENSE and license headers 2020-01-18 10:21:06 -06:00
README.md Sync README, release 2.0.0 2019-03-03 16:20:05 -06:00
build.gradle Revival updates 2020-01-18 10:04:00 -06:00
gradlew Initial commit 2019-01-20 20:39:48 -06:00
gradlew.bat Initial commit 2019-01-20 20:39:48 -06:00
settings.gradle Initial commit 2019-01-20 20:39:48 -06:00

README.md

Neutron | An open-source essential suite for the Velocity proxy

Build Status

What is Neutron?

Neutron is an open-source plugin written to try to provide the bare essentials for servers using Velocity.

How do I get it?

You can download Neutron from the CodeMC Jenkins: https://ci.codemc.org/job/Crypnotic/job/Neutron/lastSuccessfulBuild/

Neutron just entered its first release, there may still be lingering bugs

What does it offer?

Currently, Neutron offers 6 commands:

  • alert - broadcasts a message to everyone connected to the proxy
  • find - allows you to find what server another player is on
  • info - provides information regarding a player
  • glist - shows a list of all servers along with how many players are connected
  • message - sends a private message to another player
  • send- sends either a player, a server, or everyone to a specified server

Alongside the commands, Neutron offers 4 modules:

  • Announcements:
    • Announcements will be sent to all online players at set intervals
    • Multiple lists can be defined, which can run a different intervals with different messages
    • You can choose whether a list will maintain its order or be randomized
    • Each list can have a prefix, which is added to the beginning of every message in the list
  • Commands:
    • Allows the customization of all command aliases
    • Disable each command individually, or disable them all
  • Locales:
    • Translate all messages per player using pre-defined localizations
    • English(en_US) is default and currently the only locale shipped with the plugin
    • Adding locales:
      1. Copy the existing en_US.conf file and rename it to the target locale
      2. Change any messages to your liking
      3. Save the file, and run /velocity reload in-game
  • Server list:
    • Provide a custom MOTD for your server in the multiplayer server list
    • Change the max players online:
      • Current: player count matches the number of players online
      • OneMore: player count shows the number of players online plus 1
      • Ping: ping all online backend servers and sum the max player counts
      • Static: player count will always be the number defined under max-player-count
    • Change the message shown when the mouse hovers over the online player count:
      • Message: preview will show the messages defined under preview-messages
      • Players: preview matches the vanilla server preview of showing online players
      • Empty: preview is empty

Modules can be enabled/disabled in the config.conf All modules support reloading with the /velocity reload command

Permissions

Permissions are simply in the way that all command permissions are neutron.command.{command}

For example: the permission for alert is neutron.command.alert

Issues

If you run into any issues, please report them on Github: https://github.com/Crypnotic/Neutron/issues

I'm usually lurking around the Velocity discord if you want to chat about anything regarding Neutron