Compare commits
2 Commits
5dd8e6fff9
...
master
Author | SHA1 | Date | |
---|---|---|---|
f81a237f01 | |||
47281a098d |
130
README.md
130
README.md
@@ -1,51 +1,67 @@
|
|||||||
# Parasitic God
|
# Parasitic God
|
||||||
|
|
||||||

|

|
||||||

|

|
||||||

|

|
||||||

|

|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## The Concept
|
## The Concept
|
||||||
|
|
||||||
You are a nascent god, tethered to a small tribe of followers on a vibrant, living world. Their worship is your lifeblood, their growth your only purpose. You grant them miracles, blessing them with bountiful harvests and inspiring great works.
|
You are a nascent god, tethered to a small tribe of followers on a vibrant, living world. Their worship is your lifeblood, their growth your only purpose. You grant them miracles, blessing them with bountiful harvests and inspiring great works.
|
||||||
|
|
||||||
But your power comes at a cost. Every miracle that nurtures your civilization also poisons the planet. The soil turns barren, the forests wither, and the sky darkens. You are their savior and their apocalypse.
|
But your power comes at a cost. Every miracle that nurtures your civilization also poisons the planet. The soil turns barren, the forests wither, and the sky darkens. You are their savior and their apocalypse.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## The Mission
|
## The Mission
|
||||||
|
|
||||||
Guide your people from a simple tribe to a star-faring civilization capable of escaping the dying world. Manage your resources **Faith**, **Followers**, and **Production** while trying to keep the planet's ever-rising **Corruption** at bay.
|
Guide your people from a simple tribe to a star-faring civilization capable of escaping the dying world. Manage your resources **Faith**, **Followers**, and **Production** while trying to keep the planet's ever-rising **Corruption** at bay.
|
||||||
|
|
||||||
Unlock new ages of technology, build a network of cities, and perform the final, desperate miracle to launch your followers into the stars before you consume everything.
|
Unlock new ages of technology, build a network of cities, and perform the final, desperate miracle to launch your followers into the stars before you consume everything.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## Features
|
## Features
|
||||||
* **Exponential Growth**
|
|
||||||
|
- **Exponential Growth**
|
||||||
Watch a handful of followers grow into a massive civilization with huts, cities, and procedural road networks.
|
Watch a handful of followers grow into a massive civilization with huts, cities, and procedural road networks.
|
||||||
|
|
||||||
* **A World That Reacts**
|
- **A World That Reacts**
|
||||||
See the direct consequences of your actions as the vibrant globe fades to a corrupted wasteland and forests vanish based on your decisions.
|
See the direct consequences of your actions as the vibrant globe fades to a corrupted wasteland and forests vanish based on your decisions.
|
||||||
|
|
||||||
* **Deeply Moddable**
|
- **Deeply Moddable**
|
||||||
The entire game from miracles and their effects to the visual tiers of your civilization is driven by simple JSON files. If you can edit a text file, you can mod this game.
|
The entire game—from miracles and their effects to the visual tiers of your civilization—is driven by simple JSON files. If you can edit a text file, you can mod this game.
|
||||||
|
|
||||||
* **Strategic Resource Management**
|
- **Strategic Resource Management**
|
||||||
Balance the generation of multiple resources and make difficult choices. Will you sacrifice followers to purge corruption, or push for industrial growth at any cost?
|
Balance the generation of multiple resources and make difficult choices. Will you sacrifice followers to purge corruption, or push for industrial growth at any cost?
|
||||||
|
|
||||||
## **Modding Your Universe**
|
---
|
||||||
|
|
||||||
|
## Modding Your Universe
|
||||||
|
|
||||||
This game was built from the ground up to be modified. You can add new miracles, create random events, and even define new visual tiers for your civilization.
|
This game was built from the ground up to be modified. You can add new miracles, create random events, and even define new visual tiers for your civilization.
|
||||||
|
|
||||||
### **Finding the Mods Folder**
|
### Finding the Mods Folder
|
||||||
|
|
||||||
First, you need to find the game's user data directory. The game will create a Mods folder here on its first launch.
|
The game creates a `Mods` folder in its user data directory on first launch:
|
||||||
|
|
||||||
* **Windows:** %APPDATA%\\Godot\\app\_userdata\\ParasiticGod\\Mods\\
|
- **Windows:** `%APPDATA%\Godot\app_userdata\ParasiticGod\Mods\`
|
||||||
* **macOS:** \~/Library/Application Support/Godot/app\_userdata/ParasiticGod/Mods/
|
- **macOS:** `~/Library/Application Support/Godot/app_userdata/ParasiticGod/Mods/`
|
||||||
* **Linux:** \~/.local/share/godot/app\_userdata/ParasiticGod/Mods/
|
- **Linux:** `~/.local/share/godot/app_userdata/ParasiticGod/Mods/`
|
||||||
|
|
||||||
Inside, you'll find three folders: Miracles, Tiers, and Events. The game also loads a set of base mods from its installation directory (res://Mods), and any files you place in the user folder will be added to or will override the base game's content.
|
Inside, you'll find three folders: `Miracles`, `Tiers`, and `Events`.
|
||||||
|
The game also loads a set of base mods from its installation directory (`res://Mods`). Any files you place in the user folder will be added to or override the base game's content.
|
||||||
|
|
||||||
### **Creating a New Miracle**
|
---
|
||||||
|
|
||||||
To add a new miracle, simply create a new .json file in the Mods/Miracles folder. The filename will be its unique **ID** (e.g., my\_cool\_miracle.json).
|
### Creating a New Miracle
|
||||||
|
|
||||||
|
To add a new miracle, create a JSON file in `Mods/Miracles`.
|
||||||
|
The filename becomes its unique **ID** (e.g., `my_cool_miracle.json`):
|
||||||
|
|
||||||
|
```json
|
||||||
{
|
{
|
||||||
"name": "My Cool Miracle",
|
"name": "My Cool Miracle",
|
||||||
"faithCost": 100,
|
"faithCost": 100,
|
||||||
@@ -53,95 +69,109 @@ To add a new miracle, simply create a new .json file in the Mods/Miracles folder
|
|||||||
"productionRequired": 0,
|
"productionRequired": 0,
|
||||||
"unlockedByDefault": true,
|
"unlockedByDefault": true,
|
||||||
"advancesToAge": "The Cool Age",
|
"advancesToAge": "The Cool Age",
|
||||||
"effects": \[
|
"effects": [
|
||||||
{
|
{
|
||||||
"type": "AddResource",
|
"type": "AddResource",
|
||||||
"targetResource": "Faith",
|
"targetResource": "Faith",
|
||||||
"value": 200
|
"value": 200
|
||||||
}
|
}
|
||||||
\]
|
]
|
||||||
}
|
}
|
||||||
|
````
|
||||||
|
|
||||||
### **Creating a New Event**
|
---
|
||||||
|
|
||||||
To add a new random event, create a .json file in the Mods/Events folder.
|
### Creating a New Event
|
||||||
|
|
||||||
|
To add a new random event, create a JSON file in `Mods/Events`:
|
||||||
|
|
||||||
|
```json
|
||||||
{
|
{
|
||||||
"id": "event\_my\_event",
|
"id": "event_my_event",
|
||||||
"title": "A Thing Happened\!",
|
"title": "A Thing Happened!",
|
||||||
"description": "Something unexpected occurred. What will you do?",
|
"description": "Something unexpected occurred. What will you do?",
|
||||||
"meanTimeToHappen": 120,
|
"meanTimeToHappen": 120,
|
||||||
"trigger": {
|
"trigger": {
|
||||||
"minFollowers": 100,
|
"minFollowers": 100,
|
||||||
"maxCorruption": 50
|
"maxCorruption": 50
|
||||||
},
|
},
|
||||||
"options": \[
|
"options": [
|
||||||
{
|
{
|
||||||
"text": "Do the thing\!",
|
"text": "Do the thing!",
|
||||||
"tooltip": "Gain 50 Production.",
|
"tooltip": "Gain 50 Production.",
|
||||||
"effects": \[
|
"effects": [
|
||||||
{
|
{
|
||||||
"type": "AddResource",
|
"type": "AddResource",
|
||||||
"targetResource": "Production",
|
"targetResource": "Production",
|
||||||
"value": 50
|
"value": 50
|
||||||
}
|
}
|
||||||
\]
|
]
|
||||||
}
|
}
|
||||||
\]
|
]
|
||||||
}
|
}
|
||||||
|
```
|
||||||
|
|
||||||
### **Modifying Visual Tiers**
|
---
|
||||||
|
|
||||||
You can change the visual progression of followers, huts, and temples by editing the files in Mods/Tiers. The format is a list of tiers, sorted by their threshold.
|
### Modifying Visual Tiers
|
||||||
|
|
||||||
|
You can change the visual progression of followers, huts, and temples by editing the files in `Mods/Tiers`.
|
||||||
|
The format is a list of tiers, sorted by threshold:
|
||||||
|
|
||||||
|
```json
|
||||||
{
|
{
|
||||||
"tiers": \[
|
"tiers": [
|
||||||
{
|
{
|
||||||
"tierEnum": "Tier1",
|
"tierEnum": "Tier1",
|
||||||
"threshold": 0,
|
"threshold": 0,
|
||||||
"imagePath": "user://Mods/Tiers/Huts/my\_custom\_hut.png",
|
"imagePath": "user://Mods/Tiers/Huts/my_custom_hut.png",
|
||||||
"scale": { "x": 1.0, "y": 1.0 }
|
"scale": { "x": 1.0, "y": 1.0 }
|
||||||
}
|
}
|
||||||
\]
|
]
|
||||||
}
|
}
|
||||||
|
```
|
||||||
|
|
||||||
* **tierEnum**: Must be one of Tier1 through Tier10.
|
* **tierEnum**: Must be one of `Tier1` through `Tier10`.
|
||||||
* **threshold**: The number of followers needed to unlock this visual.
|
* **threshold**: The number of followers needed to unlock this visual.
|
||||||
* **imagePath**: The path to the image file. Can be a user:// path for mods or a res:// path for base game assets.
|
* **imagePath**: The path to the image file. Use `user://` for mods or `res://` for base assets.
|
||||||
* **scale**: An optional X/Y scale multiplier for the image.
|
* **scale**: Optional X/Y scale multiplier for the image.
|
||||||
|
|
||||||
### **Available Effect Types**
|
---
|
||||||
|
|
||||||
This is the core of the modding system. Both miracles and event options use this list of effects.
|
### Available Effect Types
|
||||||
|
|
||||||
|
Both miracles and event options use this list of effects:
|
||||||
|
|
||||||
| Type | Description | Parameters |
|
| Type | Description | Parameters |
|
||||||
| :---- | :---- | :---- |
|
| ------------------- | ----------------------------------- | ---------------------------------------------------------- |
|
||||||
| **AddResource** | Adds or subtracts from a core stat. | targetResource (Stat), value (number) |
|
| **AddResource** | Adds or subtracts from a core stat. | `targetResource` (Stat), `value` (number) |
|
||||||
| **ConvertResource** | Trades one resource for another. | fromResource (Stat), fromAmount (number), toResource (Stat), toAmount (number) |
|
| **ConvertResource** | Trades one resource for another. | `fromResource`, `fromAmount`, `toResource`, `toAmount` |
|
||||||
| **ModifyStat** | Permanently changes a passive stat. | targetStat (Stat), op ("Add" or "Multiply"), value (number) |
|
| **ModifyStat** | Permanently changes a passive stat. | `targetStat`, `op` ("Add" or "Multiply"), `value` |
|
||||||
| **ApplyBuff** | Applies a temporary multiplier. | buffId (string), targetStat (Stat), multiplier (number), duration (seconds) |
|
| **ApplyBuff** | Applies a temporary multiplier. | `buffId`, `targetStat`, `multiplier`, `duration` (seconds) |
|
||||||
| **UnlockMiracle** | Unlocks other miracles. | miraclesToUnlock (list of miracle IDs) |
|
| **UnlockMiracle** | Unlocks other miracles. | `miraclesToUnlock` (list of IDs) |
|
||||||
| **DestroySelf** | Removes the miracle's button after use. | (No parameters) |
|
| **DestroySelf** | Removes the miracle's button. | (No parameters) |
|
||||||
| **Win** | Triggers the game's win condition. | (No parameters) |
|
| **Win** | Triggers the game's win condition. | (No parameters) |
|
||||||
|
|
||||||
**Valid Stat Names:** Faith, Followers, Corruption, Production, ProductionPerSecond, CorruptionPerSecond, FollowersPerSecond, FaithPerFollower, ProductionPerFollower.
|
**Valid Stat Names:**
|
||||||
|
`Faith`, `Followers`, `Corruption`, `Production`, `ProductionPerSecond`, `CorruptionPerSecond`, `FollowersPerSecond`, `FaithPerFollower`, `ProductionPerFollower`
|
||||||
|
|
||||||
-----
|
---
|
||||||
|
|
||||||
## 📊 Project Stats
|
## Project Stats
|
||||||
📦 **Lines of Code:**
|
|
||||||
|
**Lines of Code:**
|
||||||

|

|
||||||
|
|
||||||
📈 **Repo Activity:**
|
**Repo Activity:**
|
||||||

|

|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
This project is open source. See the [LICENSE](https://www.google.com/search?q=./LICENSE) file for details.
|
This project is open source. See the [LICENSE](./LICENSE.txt) file for details.
|
||||||
|
|
||||||
-----
|
---
|
||||||
|
|
||||||
## Contributing
|
## Contributing
|
||||||
|
|
||||||
@@ -149,4 +179,4 @@ While the core code is complete for the jam, you can help by:
|
|||||||
|
|
||||||
* Reporting bugs or balance issues.
|
* Reporting bugs or balance issues.
|
||||||
* Creating cool new miracles and sharing them.
|
* Creating cool new miracles and sharing them.
|
||||||
* Spreading the word\!
|
* Spreading the word!
|
Reference in New Issue
Block a user