Support the development of this mod by donating. I can put more time into adding new features!
The aim of the game is to find supplies such as tools or weapons to help you survive, either alone or in a group.
The overall objective is to build a stable community and defend it from players with more hostile intentions.
Items spawn around the map in various places categorised by type, rarity and location. Vehicles are rare and spawn with damaged engines or tires and will usually spawn with loot inside the trunk.
No gameplay mechanics require the use of commands. All gameplay has been built with an intuitive interaction model in mind with only 5 major keys required to access the gamemode-specific features.
The gamemode is written in a modular fashion, borrowing a lot of concepts from object-oriented programming. The "World" scripts are separated and can be completely replaced for a new map.
I encourage people to play around with this code, create a new map and put loot spawns in it or completely mod it into a new gamemode, I would love to see what creations are made! Please publish all bug fixes in order to benefit everyone.
When you fix something, don't keep it to yourself. This is an open source project. An important part of open source is sharing, that's why this code is free of charge and available to all.
Please respect this. Feel free to keep your unique features private, just submit all fixes to the base code as pull requests or just email them to me.
Each time I compile a version of the gamemode, the build number (stored in BUILD_NUMBER) is incremented. This is also shown in-game at the top-right of the screen and will allow players and developers to know which version is in use which can help track issues and fix bugs.
IMPORTANT: DO NOT USE THE BUILD SCRIPT YOURSELF! The reason for this is that you'll change the build number which is meant to reflect which BASE version of the gamemode you are using, NOT your own builds. This will greatly improve my ability to fix issues on your server.
What version do I use?
If you're running a public server use the latest release. It should be stable but remember, this is a constantly evolving project and bugs always slip through!
If you want to hack on the code and contribute, pull the latest commit.
Ensure you have ALL the dependencies listed in the master script (the one you compile from!) each #include line has a link to the release page.
The server will automatically create any required directories such as scriptfiles/data/.
If you want to use the maps provided in the repository, extract scriptfiles/Maps.zip to scriptfiles/
If you have a problem compiling DON'T SUBMIT AN ISSUE HERE! this is reserved for actual bugs.
If you set up all the dependencies correctly, there should be no errors or warnings at all unless mentioned in the commit message.
Note: The repo contains many filterscripts, most of these are just testing tools and utilities, there are only 2 filterscripts you need to run on a public server:
filterscripts object-loader rcon
plugins crashdetect streamer sscanf CTime Whirlpool FileManager irc MapAndreas
This is an INI file with game settings that will self-create if absent.
Most of the settings should be self-explanitory. If the purpose isn't clear, look up the setting in the source code for more information.
Short Summary: https://www.tldrlegal.com/l/gpl-3.0
I don't expect you to read the entire license (Read the summary linked above).
Just ensure you understand this:
You may copy, distribute and modify the software as long as you track changes/dates in source files.
Any modifications to or software including (via compiler) GPL-licensed code must also be made available under the GPL along with build & install instructions.
And leave all credits intact.
This block is shown at the top of every source file to indicate it's under GPL:
Copyright (C) 2016 Barnaby "Southclaw" Keene
This program is free software: you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation, either version 3 of the License, or (at your
option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along
with this program. If not, see <http://www.gnu.org/licenses/>.