> For the complete documentation index, see [llms.txt](https://docs.gunchi.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gunchi.dev/scripts/community-service/installation.md).

# Installation

1. **Download the Resource**
   * Download the `gunchi-commserv` resource package
   * Extract the files to your server's resources directory
2. **File Structure**
   * Verify the resource contains the following files:
     * fxmanifest.lua
     * config.lua
     * client.lua
     * server.lua
     * menus.lua
3. **Add to Server Configuration**
   * Open your `server.cfg` file or `resources.cfg` file
   * Add the following line to ensure the resource starts:

     [`ensure gunchi-commserv`](#user-content-fn-1)[^1]
4. **Configure the Script**
   * Open [config.lua](vscode-file://vscode-app/c:/Users/User/AppData/Local/Programs/Microsoft%20VS%20Code/resources/app/out/vs/code/electron-browser/workbench/workbench.html) and customize the settings to your preference:
     * Adjust community service locations and their coordinates
     * Configure reputation scaling and progression
     * Set bribe costs and penalties
     * Customize task props and models
     * Configure staff permissions
5. **Verify Dependencies**
   * Ensure the `core` export is accessible: `exports.core:getCoreObject()`
   * Verify the `radialmenu` resource is running
6. **Test the Installation**
   * Join your server as a police officer
   * Use the radial menu under the police section
   * Test assigning community service to a player
   * Verify zones, props, and tasks spawn correctly

### Permission Configuration

Grant the appropriate permission level in your permissions system:

* Default: Police officers can assign community service
* Staff permission (configurable in [config.lua](vscode-file://vscode-app/c:/Users/User/AppData/Local/Programs/Microsoft%20VS%20Code/resources/app/out/vs/code/electron-browser/workbench/workbench.html)) allows admin override via commands

### Commands

The following commands are available after installation:

* `/commserv [id] [tasks] [location]` - Assign community service (Police/Staff)
* `/releasecs [id]` - Release player from community service (Police/Staff)
* `/cscheck` - Check your own community service status (All players)

[^1]:


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gunchi.dev/scripts/community-service/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.