CS2-MapDecals

A SwiftlyS2 plugin that allows server owners to place decals on maps at predefined locations.

Download · Report Bug · Request Feature

---

❤️ Support the Project

This project is developed and maintained purely out of passion.
If this plugin has helped you or your community, please consider supporting its development!

---

🎥 Preview

✨ Features

• Place decals at predefined locations on maps
• Supports forced and non-forced decals
• Player preference saving for non-forced decals
• Multi-database support for flexibility
• Easy configuration and automatic database setup

---

📦 Dependencies

The plugin requires the following dependencies to function correctly:

• SwiftlyS2 - v1.1.1-beta.38+ – Required core framework
• Cookies
  Used to store player preferences for toggling non-forced decals

---

Supported Databases

You can use any one of the following databases:

• MySQL / MariaDB
• PostgreSQL
• SQLite (recommended for single-server setups)

---

🚀 Installation

1. Add a database entry named cc_mapdecals to SwiftlyS2’s database.jsonc file
   (supports MySQL, PostgreSQL, and SQLite).
2. Download the latest release.
3. Extract the files into:

   addons/swiftlys2/plugins/
   

4. Start the server once to generate configuration files.
5. Configure the plugin in:

   addons/swiftlys2/configs/plugins/cc.mapdecals/
   

6. Restart the server.
   Database tables will be created automatically.

---

🕹️ Commands

Command	Description
!mapdecal	Opens the main decal menu to place decals and edit their settings. (Admin-only by default, configurable in config.json)
!decal	Toggles visibility of non-forced decals for the player. (VIP-only by default, configurable in config.json)

---

👾 Known Issues

• Per player transmit doesn't seem to work. Will fix in future version.

---

🧠 Credits & Inspiration

• Poor Map Decals
  Original concept and partial code inspiration.
• K4-LevelRanks-SwiftlyS2
  Architecture and structural inspiration.