Skip to content
Fallout System in Minecraft (Radiation, Fatigue, Thirst, Hunger)
Java
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib
src/main
.gitignore
README.md
build.xml
plugin.yml
pom.xml

README.md

FalloutCraft--- Powered by LogoCat

mcfallout Jar Download link: Spigot Page

I am personally a Fallout fan. Why not bringing fallout's hardcore survival mode to minecraft bed? This plugin is a minecraft server-side spigot plugin in order to enhance the experience of:

  • Fallout System in Minecraft (Radiation, Fatigue, Thirst)
  • Just like fallout! Enjoy your Apocalyptic Survival game.


Features :

Enhanced survival mechanism :

  • Fatigue bed

    1. Fatigue gives you some debuffs depends on how tired you are.
    2. Increase when time passes. 50 to 100(RNG based) per 20mins
    3. Decrease when player lays on bed.
    4. Laying on bed gives you [well rested status] providing you 20% of [damage resistance] potion effect.
  • Dehydration

    1. Dehydration gives you some debuffs depends on how dehydrated you are.
    2. Increase when having certain types of food (Such as eating potato , bread , rotten flesh , and catching on fire fire.
    3. Decrease when players drink from water bottle or any kind of potions.
  • Radiation

    1. Radiation first gives you some mutation buffs like night vision. However when the level increases, the debuffs start to appear.
    2. Increase when players hit by creature, and eating food based on the food's radiation level.(Rotten flesh obviously does more than apples .)
    3. Decrease when players drink [radaway].

Item crafting :

  • Radaway Recipe Radaway is the only way to decrease your radiation level other than Golen Apple . Multiple kinds of Radaways are craftable using 3x3 crafting table or player's 2x2 crafting menu.
    1. Level 1 Radaway : bone meal + water bottle
    2. Level 2 Radaway : bone + water bottle
    3. Level 4 Radawat : bone block + water bottle

Media Demo:

  • Image 1 : Text output (show when player receives changes on one of the survival mechanism)
  • Image 2 : placeholderapi support (show with titlemanager)

Environment

This build is compiled and tested on these environments.

Hard-Dependency

This plugin needs to run with the following plugins with the latest version to work properly:

  • placeholderapi - making plugin to work with each others parameters or output.

Soft-Dependency

This plugin run with best experience the following plugins :

  • placeholderapi - making plugin to work with each others parameters or output.
  • titlemanager - player could easily know their status by press 'tab' or watching scoreboard

Installation

  1. Drop the plugin jar file in your server folder /plugins/ and run once.
  2. After the plugin folder and default config.yml is generated, stop the server.
  3. Start to set your own config withing config.yml.

Configuration setting

  1. The messages are all configurable. You can edit them based on the name tag like [SOMEONE_DIED_BECAUSE_OF_RADIATION].
  2. Color codes escapes are represented with '§'.
  3. Since all of the increase, decrease amount of radiation/dehydration is customisable. I only take one of them as example.
thirst_poisonous_potato: '50'
# then value >0, increase the dehydration level, otherwise <0 decreases.
YOUR_RADIATION_0_200_MES: ''
# when radation reaches 200 from 400. Show these texts. Defaultly blank. 
YOUR_RADIATION_201_400_MES: 'Your §cradiation sickness§f : §b*---'
# when radation reaches 201~400. Show these texts.
YOUR_RADIATION_401_600_MES: 'Your §cradiation sickness§f : §a**--'
YOUR_RADIATION_601_800_MES: 'Your §cradiation sickness§f : §e***-'
YOUR_RADIATION_801_999_MES: 'Your §cradiation sickness§f : §c****'
# Trivial.

Permission nodes

nodes description default
falloutcraft.* Gives access to all fallout commands
falloutcraft.fostatus check falloutcraft status. true
falloutcraft.setradiation permission to use command : /fosetr op
falloutcraft.setdehydration permission to use command : /foseth op
falloutcraft.setfatigue permission to use command : /fosetf op

Commands

command description required permission
/fostatus check falloutcraft status true
/foupdate this is a dummy command for debugging, forcing the plugin to update all players potion effect gained from those three survival mechanisms. op
/fosetr [id] [lvl] set the player's radiation level falloutcraft.setradiation
/fosetd [id] [lvl] set the player's dehydration level falloutcraft.setdehydration
/fosetf [id] [lvl] set the player's fatigue level falloutcraft.setfatigue

Todos

  • Write MORE Tests
  • Add Night Mode

Development

Want to contribute? Great! This project is open to everyone as long as it follows the license. You could follow these steps to build up the developing environment :

  1. Click here for instrctions of importing a maven project.
  2. Add the dependent plugin .jar file mentioned above.
  3. Run the project as 'maven install'
  4. The built version would be in /$project_name/target/

License

MIT licenses https://opensource.org/licenses/MIT THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

You can’t perform that action at this time.