=Welcome to "Psukhe-survival" AI Survival Simulator=

See the leaderboard: http://ec2-52-56-250-10.eu-west-2.compute.amazonaws.com/ Black dots are characters - Red = Land Height, Green = Vegetation, Blue = Water

==Theme: ==

===Your life is currency, everything about you can be sold (other than your organs)===

• Work together to collect EV Point
• Trade your Health, Give someone Oxygen, food or Water in exchange for something you need.
• Sell scripts you write to other players to help them create advanced AI systems

Ever played one of those evolution games where you start out as a cell, and work your way up the tree of life, until you're an apex predator with 52 eyes, ultra long legs and somehow you breath fire?

==Inspiration==

Those games are fun, and they are the inspiration behind Psukhe-survival.

In Psukhe-survival you're a gelatinous mass of flesh with dreams! Electric dreams! One day you're going to be something! You're going to make something of yourself! You're going to start a family (err what?)

==How to play==

This games going to be a little different, and so I'm going to skip the rest of the humour to give you the raw how to play info: Psukhe-survival is a scripting game. When you download the game you're going to get a Node application. It's run-able as is, and you will survive for a little while, but if you want to really survive and make something of yourself, then you're going to have to grow the brain of your organism (do some scripting) so it can make more intelligent choices.

When you start out, you're going to wonder around aimlessly, drinking when you're thirsty, eating when you're hungry. If you wonder off into a desert, you're going to die of thirst. If you were a little smarter, you would avoid wondering into a desert.

If you can survive a little while, you're going to get EV Points (Evolution points) which you can spend to evolve yourself. You'll get more options as you get more EV Points. Eventually you could have dragon like armour, thermal vision, toxic flesh and highly oxygenated blood! Think of what that creature's going to look like!

Now remember those big dreams you had? The one about having a family? Well what's the fun of being alone? Why not do some breeding while you're playing? you can start of with Mitosis, if you live long enough, you might be able to lay an egg! - Having trouble finding a partner for your breeding program? Well not a problem any more, you have the option of Parthenogenesis!!! All your problems can be solved.

I really hope y'all have fun playing this game. If like me the best part of Minecraft was coding the Turtle to mine for you, or you ever wanted to simulate some AI. Or maybe you know someone who would like to learn to code, why not have some fun with them scripting simple AI (really simple AI, don't scope creep too much :) - but whoever develops a hive mind! please let me know I really really want to see someone make a hive mind!!!)

== How to play the game ==

Go to the Github page

Fork my repo

Go to where you want to download the game to in oyur file system

git clone https://github.com/${{Yous Username Here}}/psukhe-survival.git

Inside the newly created "psukhe-survival" folder, you have two subfolders: "server" and "client"

If you're just wanting to play, head into the "client" folder.

You're going to need nodejs, npm, typescript to launch/play the game.

If you don't have node, head to https://nodejs.org/en/download/ or use your favourite version management software to download nodejs.

Node comes bundles with "NPM" (Node Package Management) - so in a terminal type "npm install -g tsc" which will install typescript on your machine. I recommend "npm install -g tsc-watch" and "npm install -g nodemon" which are both handy little tools for auto-compiling your code and auto-running your code when you make changes, so there's no manual compile and run delays.

in a terminal navigate into the client folder and run "tsc" which will run typescript's compiler.

cd build

^^^ Will move you into the build directory that tsc created.

node index.js

^^^ Will run the game

You're not going to see too much for 30 seconds, just a spawn message and waiting. Once your character gets hungry or thirsty, they are going to start exploring looking for food/water.

Playing the game means looking inside the "src" folder, and scripting your AI to be better at survival/hunting/running than other people's AI's.

==Cheatsheet==

/src/controller/mind contains the current 'what to do when X happens' code, which is pretty simple.

/src/controller/eye || ear || nose - these are empty templates linked to eye, ear and nose events. You'll use these as you start to evolve.

/src/controller/intent - This contains all of the actions that you can perform. From moving, eating and drinking to evolving your creature.

Expand the client as much as you like, feel free to develop in other languages or in other ways. The only caveat being that you need to be able to communicate with the server, so check out socket.io which the server is using for network comms.

Good luck, and happy hunting