# MX-HELL
Hell portal system for **RedM**. Place a sigil, open a portal, and travel to another world with blood moon, NPC, and ritual.
**Version:** 1.0.0
**Author:** MX-SCRIPTS
---
## Features
- Place `sigil_fire` sigil with conjuration ritual
- Temporary entry portal + permanent return portal in hell
- Isolated instances per portal (routing buckets)
- Blood moon sky while in hell
- Hell NPC with dialogue and circle ritual
- RSG / VORP support
---
## Dependencies
- `ox_lib`
- `oxmysql`
- `MXRite-Sigils`
- `rsg-core` **or** `vorp_core` + inventory
```cfg
ensure ox_lib
ensure oxmysql
ensure MXRite-Sigils
ensure MX-Hell
```
---
## Installation
1. Put `MX-Hell` in your resources folder
2. Run `sql/mx_hell_portals.sql` (or let the script create tables on start)
3. Add the item from `ITEMS.sql` (`mx_hell_sigil_charm`)
4. Add item image to your inventory images folder
5. `ensure MX-Hell` in `server.cfg`
---
## Usage
1. Use item `mx_hell_sigil_charm` or `/hell-sigil`
2. Place the sigil on the ground and confirm
3. Wait for conjuration — entry portal opens
4. Enter the portal to go to hell
5. Exit through the return portal in hell
| Command | Description |
|---------|-------------|
| `/hell-sigil` | Place a portal |
| `/hell-remove` | Remove nearby entry portal (owner/admin) |
---
## Main config (`config.lua`)
```lua
Config.Framework = 'auto' -- 'auto' | 'rsg' | 'vorp'
Config.HellItem = 'mx_hell_sigil_charm'
Config.HellDestination = vector3(-1100.3295, 2131.5332, 357.2443)
Config.HellRoutingBucket = 666000
Config.HellInstancePerPortal = true -- separate worlds per portal
Config.PortalLifetime = 120 -- entry portal open time (seconds, 0 = forever)
```
Edit texts in `locales.lua`.
---
## Notes
- Requires `MXRite-Sigils` for the `sigil_fire` prop
- Friends who enter the **same** portal share the same hell instance
- Players from **different** portals do not see each other