# Dystopika Asset Project

Hey choom,

You're probably wondering what this project is all about. In a nutshell, this project was initiated by the [CORTEX IMPLANT](https://corteximplant.com) community and its friends. CORTEX IMPLANT is a Cyberpunk community within the [OBEY THE SYSTEM](https://obeythesystem.com/) network. For this project, we're creating in-game billboards for the dystopian building game, *[Dystopika](https://dystopika.com/)*. Why, you ask? The Cyberpunk setting of our community aligns perfectly with the game, and we take great pleasure in providing cool and immersive content to players.

![](https://corteximplant.com/system/media_attachments/files/112/662/263/489/654/209/original/839318e978218388.jpeg)

## Installation

To use our community assets in Dystopika, simply follow these steps:

- [Download](https://git.cyberwa.re/revengeday/dystopika-asset-project/archive/main.zip) the dystopika-ads folder from this repository.
- Copy the contents of the dystopika-ads folder.
- Navigate to the `My Documents/Dystopika/ImportAds` directory on your computer.
- Paste the copied files into the ImportAds folder. 

If the ImportAds folder doesn't exist, you can create it manually. Once the files are in place, launch Dystopika and enjoy the new in-game billboards provided by the CORTEX IMPLANT and Friends community.

### Troubleshooting: Community Ads Not Displaying on PC

If our community ads are not appearing in the game, follow these steps to resolve the issue:

#### Step 1: Verify Folder Location

1. **Check the Folder Path**
   Ensure that the ad images are placed in the correct folder location on your computer:
   
   ```
   My Documents/Dystopika/ImportAds
   ```

   - Navigate to `My Documents`.
   - Open the `Dystopika` folder.
   - Confirm that your ad images are in the `ImportAds` folder. If the folder doesn't exist, create it and place your ad images inside.

#### Step 2: Manual Import in Game

If the ads still do not appear in the game, you can manually import them using the game's built-in feature:

1. **Place an Ad in the Game**
   - Enter the game and navigate to the area where you want to place the ad.

2. **Open Import Menu**
   - Press the `I` key to open the Import Menu.

3. **Manual Import**
   - Use the Import Menu to manually select and import your ad images into the game.

### Troubleshooting: Community Ads Not Displaying on Steam Deck

If the ads still do not appear in the game, you can manually import them using the game's built-in feature on your Steam Deck:

1. **Mapped Key for Import Menu**
   - Ensure that you have mapped a button to the "I" key. For example, you can map `R5` (right back button) to the "I" key to open the file browser easily.

2. **Place an Ad in the Game**
   - Enter the game and navigate to the area where you want to place the ad.

3. **Open Import Menu**
   - Press the `R5` button to open the Import Menu.

4. **Manual Import**
   - Use the Import Menu to manually select and import your ad images into the game. Note that on your system, `D:` is the microSD card and `Z:` is the actual directory.

#### Transferring Files to Steam Deck

You can transfer files to your Steam Deck using different methods:

1. **Using Syncthing**
   - Set up Syncthing to synchronize files between your main computer and your Steam Deck. This allows you to easily transfer ad images in and out of the Steam Deck.

2. **Using SFTP**
   - You can also use SFTP (Secure File Transfer Protocol) to transfer files to your Steam Deck. Make sure you have an SFTP client installed on your main computer and follow the necessary steps to connect to your Steam Deck.

   
Thanks to [Benji](https://corteximplant.com/@benji) for the SteamDeck guide!

## Contributing

We welcome your contributions to our project! Here's how you can get started:

### How to Contribute via Git

1. **Fork the Repository**  
   Click the "Fork" button to create your own copy of the repository.

2. **Clone Your Fork**  
   Clone the forked repository to your local machine:

   ```sh
   git clone https://git.cyberwa.re/revengeday/dystopika-asset-project.git
   ```

3. **Create a New Branch**  
   Create a new branch for your feature or fix:

   ```sh
   cd dystopika-asset-project
   git checkout -b your-feature-branch
   ```

4. **Make Your Changes**  
   Implement your feature or fix the issue.

5. **Commit Your Changes**  
   Commit your changes with a descriptive message:

   ```sh
   git add .
   git commit -m "Describe your changes"
   ```

6. **Push to Your Fork**  
   Push the changes to your forked repository:

   ```sh
   git push origin your-feature-branch
   ```

7. **Submit a Pull Request**  
   Go to the original repository on https://git.cyberwa.re and submit a Pull Request with a clear description of your changes.
   
#### Info: git.cyberwa.re Account

If you need a git.cyberwa.re account, please contact [@revengeday@corteximplant.com](https://corteximplant.com/@revengeday).
   
### No Git?

No problem! If you're not familiar with Git, you can still contribute:

1. **Create Your Graphic**  
   Design the graphic you want to contribute.

2. **Send It to Us**  
   Send your graphic to our Fediverse account at [@revengeday@corteximplant.com](https://corteximplant.com/@revengeday). We'll take care of adding it to the repository.
   
### Contributing Designs

For those contributing designs, please follow these guidelines:

1. **Style**  
   The style should remain Cyberpunk. Think neon lights, gritty textures, and futuristic elements.

2. **Aspect Ratios and Sizes**  
   To ensure the in-game ads look good, please adhere to the following aspect ratios and sizes:

   | Aspect Ratio | Size      |
   |--------------|-----------|
   | 1:1          | 1280x1280 |
   | 1:2          | 1280x2560 |
   | 2:1          | 1280x640  |

3. **Use Templates**  
   In the `templates` folder, you will find pre-sized image files that you can use as a starting point for your designs.

### Need Help?

If you have questions or need assistance, feel free to open an issue or contact us directly. We look forward to your contributions! 🚀
   
## License

By using the assets in this repository, you agree to the following terms:

### Non-Commercial Use

You are free to use, copy, and modify the assets for personal and educational purposes. Commercial use is strictly prohibited.

### No Redistribution

Uploading any of the assets in this repository to other websites or platforms is not permitted.

### Copyright Protection

Some graphics and logos included in this project are protected by copyright laws and cannot be used without explicit permission from the copyright holders. This includes, but is not limited to:

- **[CORTEX IMPLANT](https://corteximplant.com)**
- **[NIGHT CITY BAR](https://nightcity.bar/)**
- **[TOTENTANZ](https://totentanz.club/)**
- **[REVENGEDAY](https://revenge.day/)**
- **[CYBERWARE](https://cyberwa.re/)**
- **[CYBER.MS](https://cyber.ms/about)**
- **[OBEY THE SYSTEM](https://obeythesystem.com/)**

### Attribution

If you use or modify any of the assets, please give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
## Contact Information

If you have any questions, need assistance, or want to share ideas, feel free to reach out to us:

- **Email:** [dystopika-asset-project@revenge.day](mailto:dystopika-asset-project@revenge.day)
- **Fediverse:** [@revengeday@corteximplant.com](https://corteximplant.com/@revengeday)

You can also open an issue on our repository if you encounter any problems or have suggestions. We're here to help and look forward to your contributions! 🚀

## Disclaimer

This project is not partnered with, endorsed by, or in contact with the developers of the game **Dystopika**. All assets are fan-made and independently created.