Fork of leomelki/LoupGarou by TheOptimisticFactory

• This repository is based off https://github.com/leomelki/LoupGarou and contains improvements made by the community before it lands in the main repository (if ever).

  • Should you need it, you can consult its original readme at https://github.com/TheOptimisticFactory/LoupGarou/blob/dev/README.legacy.md (snapshot taken on 2024-12-05). Bear in mind the discrepancies that can exist with this repository.

• The dev branch is STABLE, despite his name. The wip branch, on the other hand might not

How to run the project

• The simplest way to run this project is to a pre-configured server files containing the compiled jar of my fork can be found at: https://github.com/TheOptimisticFactory/java-minecraft-loupGarou-server
  • Follow these instructions to get it running in no time.

Plugin jar

• The jar itself is downloadable from https://github.com/TheOptimisticFactory/java-minecraft-loupGarou-server/tree/master/plugins (dont forget the config file)

Additional features compared to original plugin

As of today (2020/05/11), the original repository version is v1.1.0, released on 2020/04/07.

My repository includes the same content along with the following additions (each link contains screenshots):

• fork v1.2.0 - Village composition showcase at the end of the game
• fork v1.3.0 - Ability to set nicknames to players + GUI to configure roles and start game
• fork v1.4.0 - Customizable memes messages at the start of the game + Highlight of the % of votes on a given player
• fork v1.5.0 - Revamped scoreboard to avoid useless scoring + Server logs when a player dies or gets resurrected
• fork v1.6.0 - Persisted round results for postgame analytics in CSV format
• fork v1.7.0 - Ability to hide the scoreboard to enable role bluffing
• fork v1.8.0 - Ability to randomize role attribution
• fork v1.9.0 - Revamped command parser + revamped codebase to ease adding new roles
• fork v1.10.0 - Added commands to showcase random distribution

Useful commands (for ops)

• /lg joinAll to make everyone connected join the lobby
• /lg start to start the game
• /lg end to interrupt an ongoing game
• /lg addSpawn to add a spawn-point on your EXACT position and look direction
• /lg roles to get the list of currently active roles
• /lg roles list to get the complete list of available roles
• /lg roles set <role> <amount> to set the number of players for a given role

Additional commands compared to baseline repository:

• /lg nick <username> <nickname> to set a nickname to a player
• /lg unnick <username> to remove a nickname from a player
• /lg random to list the probability to picking each role with a weight > 0
• /lg random showAll to list the probability to picking each role (disregarding their weight)
• /lg random players <amount> to set the number of players when using random role distribution

Additional features gallery

Notes for compilation

• The following compilation warning is normal and can safely be ignored: WARNING: Illegal reflective access by com.comphenix.net.sf.cglib.core.ReflectUtils$1 (file:<path>) to method java.lang.ClassLoader.defineClass(java.lang.String,byte[],int,int,java.security.ProtectionDomain). It is due to the fact that ProtocolLib currently does not support Java versions above Java 8 and won't until Mojang and Spigot decide to update.