> For the complete documentation index, see [llms.txt](https://code-after-sex.gitbook.io/script-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://code-after-sex.gitbook.io/script-documentation/cas-duel-arena-system/redm-duel-and-arena-system.md).

# RedM Duel & Arena System

RedM Duel & Arena System: a complete duel script for VORP, RSG Core and standalone. Ranked ELO duels, tournaments, NPC outlaws, spectating and side bets.

**CAS Duel is a complete western duel system for RedM. Call someone out, walk your paces, wait for the signal and draw.**

{% hint style="success" %}
Works on **VORP Core**, **RSG Core** and **standalone** servers. The framework is detected on its own and oxmysql is optional. There is no SQL file to import.
{% endhint %}

RedM Duel & Arena System turns gunfights into proper duels. Two players face each other in a real street, walk their paces back to back, turn, hold still through the countdown and draw on the signal. The server referees every round: it runs the clock, decides who drew first, scores the hits, settles the wagers and updates the ratings.

Around the duel itself you get everything a server needs to build a scene: ranked matchmaking with ELO ratings, an open challenge board, single elimination tournaments, NPC outlaws to practise on, a spectator camera with side bets, player profiles, match history and achievements.

## Highlights

* **Eight duel modes.** Classic Duel, Quick Draw, Best of 3, Best of 5, First to X, Headshot Only, One Shot and Melee.
* **Player challenges** with wagers, custom rules, and a 30 second window to answer.
* **Ranked matchmaking** with ELO ratings, rating tiers and a season leaderboard.
* **Open challenge board** where anyone can take up a posted duel.
* **Tournaments** with entry fees, prize pools and brackets that dispatch their own matches.
* **NPC outlaws** at four difficulties, with bounties, for practice.
* **Spectating** from a fixed street camera, with **side bets** on either shooter.
* **Profiles, match history, titles, server records and 12 achievements.**
* **Private routing bucket for every match**, so a duel never collides with the rest of the server.
* **In-game arena tool** that measures a street and writes the config line for you.
* **A menu built from Red Dead Redemption 2's own UI textures and fonts.**
* **Fully translatable.** English and Turkish included. The menu, HUD, notifications and server messages all come from one language file.

## At a glance

|                           |                                                                      |
| ------------------------- | -------------------------------------------------------------------- |
| **Resource name**         | `cas-duel`                                                           |
| **Version**               | 1.0.0                                                                |
| **Frameworks**            | VORP Core, RSG Core, standalone (auto-detected)                      |
| **Storage**               | oxmysql with tables created automatically, or the built-in KVP store |
| **Required dependencies** | None                                                                 |
| **Player command**        | `/duels`                                                             |
| **Admin command**         | `/duel_admin` (ACE permission `duels.admin`)                         |
| **Duel modes**            | 8                                                                    |
| **Arenas**                | 8 included, add your own in game                                     |
| **Weapons**               | 6 sidearms, hunting knife, bare knuckles                             |
| **Languages**             | English, Turkish, add your own                                       |

## Three things to do first

1. [Install the resource](/script-documentation/cas-duel-arena-system/installation.md) and start it after your framework and oxmysql.
2. [Grant the admin permission](/script-documentation/cas-duel-arena-system/permissions.md) so you can run tournaments and measure arenas.
3. [Check the arenas](/script-documentation/cas-duel-arena-system/arenas.md) on your map. The included streets are measured on the default map; if your server has custom buildings, measure them again.

Everything else has a working default.

## Where to start

| I want to                                 | Read                                                                                                               |
| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Get it running                            | [Installation](/script-documentation/cas-duel-arena-system/installation.md)                                        |
| Understand how it works with my framework | [VORP, RSG Core and Standalone](/script-documentation/cas-duel-arena-system/frameworks.md)                         |
| Let my admins manage duels                | [Permissions](/script-documentation/cas-duel-arena-system/permissions.md)                                          |
| See every command and key                 | [Commands and Controls](/script-documentation/cas-duel-arena-system/commands.md)                                   |
| Learn the modes and rules                 | [Duel Modes and Rules](/script-documentation/cas-duel-arena-system/duel-modes.md)                                  |
| Add or fix an arena                       | [Arenas](/script-documentation/cas-duel-arena-system/arenas.md)                                                    |
| Set up ranked play                        | [Ranked Matchmaking](/script-documentation/cas-duel-arena-system/matchmaking.md)                                   |
| Run tournaments                           | [Tournaments](/script-documentation/cas-duel-arena-system/tournaments.md)                                          |
| Tune the NPC outlaws                      | [NPC Outlaw Duels](/script-documentation/cas-duel-arena-system/npc-outlaws.md)                                     |
| Understand wagers and bets                | [Wagers, Side Bets and Payouts](/script-documentation/cas-duel-arena-system/wagers-and-betting.md)                 |
| Watch other duels                         | [Spectating Live Duels](/script-documentation/cas-duel-arena-system/spectating.md)                                 |
| Change stats, titles or achievements      | [Profiles, Leaderboard and Achievements](/script-documentation/cas-duel-arena-system/profiles-and-achievements.md) |
| Change any setting                        | [Configuration](/script-documentation/cas-duel-arena-system/configuration.md)                                      |
| Change the language or any text           | [Languages and Translation](/script-documentation/cas-duel-arena-system/languages.md)                              |
| Change how the menu looks                 | [Editing the Interface](/script-documentation/cas-duel-arena-system/interface.md)                                  |
| Fix a problem                             | [Troubleshooting](/script-documentation/cas-duel-arena-system/troubleshooting.md)                                  |
| Get a quick answer                        | [FAQ](/script-documentation/cas-duel-arena-system/faq.md)                                                          |

***

CAS Duel is made by UIforc for CAS.

## Get the script

Advanced Duel & Arena System is sold on the CAS Scripts store: [codeaftersex.com/script/advanced-duel-and-arena-system](https://codeaftersex.com/script/advanced-duel-and-arena-system). Both the Escrow build and the full Open Source build are listed there, with lifetime updates and Discord support.
