botany/README.md

74 lines
2.5 KiB
Markdown
Raw Normal View History

2017-03-06 21:36:27 +00:00
# botany
2017-03-24 23:32:58 +00:00
![Screencap](http://tilde.town/~curiouser/botanybeta4.png)
2017-03-15 21:42:34 +00:00
2017-03-14 22:50:03 +00:00
by Jake Funke - jifunks@gmail.com - tilde.town/~curiouser - http://jakefunke.online/
2017-03-10 04:54:38 +00:00
A command line, realtime, community plant buddy.
You've been given a seed that will grow into a beautiful plant.
Check in and water your plant every 24h to keep it growing. 5 days without water = death. Your plant depends on you to live!
2017-03-24 02:34:14 +00:00
*"We do not 'come into' this world; we come out of it, as leaves from a tree." - Alan Watts*
2017-03-10 04:54:38 +00:00
*(work in progress)*
## getting started
2017-03-17 22:03:32 +00:00
botany is designed for unix-based systems. Clone into a local directory using `$ git clone https://github.com/jifunks/botany.git`.
2017-03-17 19:00:46 +00:00
2017-03-17 22:03:32 +00:00
Run with `$ python botany.py`.
2017-03-18 00:33:40 +00:00
2017-03-15 21:35:14 +00:00
*Note - botany.py must initially be run by the user who cloned/unzipped
botany.py - this initalizes the shared data file permissions.*
2017-03-15 21:42:34 +00:00
2017-03-17 19:00:46 +00:00
Water your seed to get started. You can come and go as you please and your plant continues to grow.
Make sure to come back and water every 24 hours or your plant won't grow.
If your plant goes 5 days without water, it will die!
2017-03-10 04:54:38 +00:00
## features
2017-03-17 22:03:32 +00:00
* Curses-based menu system, optimized for 80x24 terminal
* 20+ Species of plants w/ ASCII art for each
2017-03-10 04:54:38 +00:00
* Persistent aging system that allows your plant to grow even when app is closed
* Random and rare mutations can occur at any point in a plant's life
2017-03-23 01:49:38 +00:00
* SQLite Community Garden of other users' plants (for shared unix servers)
* Data files are created in the user's home (~) directory, along with a JSON file that can be used in other apps.
2017-03-24 01:32:44 +00:00
* Data is created for your current plant and harvested plants
2017-03-15 21:42:34 +00:00
2017-03-10 04:54:38 +00:00
```
{
"description":"common singing blue seed-bearing poppy",
"file_name":"/Users/jakefunke/.botany/jakefunke_plant.dat",
"age":"0d:2h:3m:16s",
"score":1730,
"owner":"jakefunke",
"is_dead":false,
"last_watered":1489113197
}
```
2017-03-15 21:35:14 +00:00
### testing features
* ASCII art only shows first few stages of growth - more coming soon!
2017-03-10 04:54:38 +00:00
2017-03-15 21:35:14 +00:00
### to-dos
2017-03-21 19:55:11 +00:00
* Finish garden feature
2017-03-24 01:32:44 +00:00
* Water neighbor's plants
2017-03-21 19:55:11 +00:00
* Harvest plant at end of life (gather seeds)
2017-03-24 01:32:44 +00:00
* Plant pollination - cross-breed with neighbor plants to unlock second-gen plants
* Share seeds with other users
2017-03-10 04:54:38 +00:00
* Global events
2017-03-24 01:32:44 +00:00
* Server API to have rain storms, heat waves, insects
2017-03-14 22:50:03 +00:00
* Name your plant
* Reward for keeping plant alive
2017-03-17 19:00:46 +00:00
* Hybridization, multiple generations, lineage tracking
2017-03-10 04:54:38 +00:00
## requirements
* Unix-based OS (Mac, Linux)
* Python 2.x
2017-03-17 22:03:32 +00:00
* Recommended: 80x24 minimum terminal, fixed-width font
2017-03-10 04:54:38 +00:00
## credits
* thank you tilde.town for inspiration!
2017-03-10 18:15:22 +00:00
* Thank you @etkirsch for [this gist](https://gist.github.com/etkirsch/53505478f53aeeac24a5) - python curses can be nightmarish!