eggwars/README.md

71 lines
3.7 KiB
Markdown
Raw Permalink Normal View History

2017-07-23 19:01:51 -07:00
# Eggwars
2017-07-23 20:42:23 -07:00
## What this is
2017-07-23 19:11:17 -07:00
This mod is inspired by the Minecraft mod of the same name and has similar features.
2017-07-23 19:01:51 -07:00
2021-12-10 14:22:59 -08:00
Each player's goal is to defend their egg and be the last person standing. If a player dies either from being killed by another player or falling off, they will re-spawn whilst their egg is intact, if it has been destroyed, they experience match death and enter into spectator mode.
2017-07-23 19:11:17 -07:00
When there is one player left standing in a match, they are declared the winner.
2020-09-02 14:59:32 -07:00
![](screenshots/screenshot.png)
![](screenshots/screenshot_2.png)
![](screenshots/screenshot_3.png)
## Features
* Lobby
* Multiple match instances
* Island NPC Trader shops
* Island NPC Spawner Upgrades
* Coloured match chat
* API for adding content
2017-07-23 19:11:17 -07:00
2017-07-23 20:42:23 -07:00
## Install
2020-09-02 14:59:32 -07:00
This mod is designed to run on a server with the map running in a ram disk. There is no requirement for persistence of the map data so you should arrange to delete it on every restart, the memory requirements are low with the default arena taking ~5MB all 8 arenas should fit within 56MB.
First copy MTG to a new folder in minetest/games called eggwars and either extract the zip file to mods/ **or** use `git clone https://github.com/shivajiva101/eggwars` from within the mods directory.
2017-07-23 19:11:17 -07:00
2017-07-23 19:35:42 -07:00
* Do **NOT** use an existing world - this will overwrite the mapgen and cause destruction.
2020-09-02 14:59:32 -07:00
* Do **NOT** use a different mapgen mod. This will also cause issues
* Delete the mods you don't need like beds, boats, bucket, butterflies, carts, dungeon_loot, fireflies, give_initial_stuff, sethome, spawn, vessels, weather
###### Additionally it is highly recommended that you add these mods:
2020-09-21 11:33:16 -07:00
* Playertag [https://github.com/shivajiva101/playertag]
* Gauges [https://github.com/shivajiva101/gauges]
* 3D armor [ https://github.com/minetest-mods/3d_armor ]
* Bows [ https://notabug.org/TenPlus1/bows ]
2017-07-23 19:11:17 -07:00
2020-09-02 16:49:40 -07:00
###### Example bash script for a server using levelDb:
2020-09-02 14:59:32 -07:00
![](screenshots/ramdisk.png)
2020-09-02 16:49:40 -07:00
Use ``sudo sh eggwars.sh`` to run the script as root for ramdisk management, sudo commands in the script perform actions as the user to keep things secure.
## Adding your own arena
Adding your own arena is easy via the API function ``eggwars.register_arena(def) ``
the default definition can be found in ``register_arena.lua `` and should be used as the reference template for creating your own arenas, it's a keypair table proliferated with comments to help understand what data each key requires. This design concept allows you to use your own schematics for islands, arena hubs and spawner satellites, controlling the positions of all current arena elements. See API.md for more details on this mods API functions and how to use them.
2020-06-02 16:37:46 -07:00
## License
This project is licensed under AGPL v3. This is similar to the GPLv3, but requires any code modifications to be available on request.
2020-06-02 16:37:46 -07:00
## Contributors
This project was originally started by wilkgr, but after years of inactivity handed over to shivajiva.
2020-08-13 09:20:36 -07:00
## Media Attribution & Licenses
###### Sounds:
* eggwars_winner.ogg uses https://freesound.org/s/406371/ by SoundBat (CC0 1.0)
* eggwars_out.ogg uses https://freesound.org/s/350985/ by cabled_mess (CC0 1.0)
* eggwars_game_over.ogg uses https://freesound.org/s/277403/ by landlucky (CC BY 3.0)
* eggwars_time_over.ogg uses https://freesound.org/s/437661/ by dersuperanton (CC BY 3.0)
* eggwars_sudden.ogg uses https://freesound.org/s/476176/ by umdamlar (CC0 1.0)
2020-09-21 11:33:16 -07:00
* eggwars_crack.ogg uses https://freesound.org/s/444365/ by cj_ascoli (CC0 1.0)
###### Textures:
2020-09-21 11:33:16 -07:00
* Textures by shivajiva, created with Gimp (CC BY-NC 4.0)
2020-08-13 09:20:36 -07:00
###### Models:
* Egg mesh by shivajiva, created with Blender (CC BY-NC 4.0)
* NPC Character model sourced from minetest_game v0.4.17 (CC BY-SA 3.0) see minetest_game/mods/default/license.txt
###### Schematics:
* created in MT by shivajiva (CC BY-NC 4.0)