Mexicano Scripts

Author: MX-SCRIPTS

Support: https://discord.gg/JBJUyJQfcf

DESCRIPTION

-------------

MX-ritual-indigena is an immersive spiritual ritual system for RedM. Players use a ritual kit item to place a totem on the ground, walk around to set corner markers, deposit offerings through a NUI menu, and invoke the ritual. While the ceremony runs, nearby players experience rain, layered music, particle effects, dancing animations, a spirit eagle, and spirit animals. Only one ritual can run on the server at a time.

DEPENDENCIES

------------

- ox_lib

- oxmysql

- RSG Core or VORP (auto-detected, or set manually in config.lua)

Optional:

- weathersync (recommended for local rain weather; works without it using native weather)

RITUAL PHASES (default 60 seconds)

----------------------------------

Timings are in milliseconds from ritual start. Edit in config.lua under timings.

0s Ritual begins. Prompts hidden for everyone. Proximity rain and music start for nearby players.

5s Smoke particle on center totem.

10s Energy particles pulse on players in range (repeating).

18s Spirit eagle spawns in front of whoever started the ritual and flies to land near the totem.

24s Spirit animals (buffalo) walk in from outside the circle.

44s Climax: corner props ignite, music volume increases.

60s Ritual ends. Animals and eagle removed. Music stops. Rain clears after linger period.

PROXIMITY EFFECTS (local per player)

------------------------------------

Rain:

- Only players within rain.range (default 25m) see rain during the ritual.

- Leaving the area clears weather for that player.

- Rain may linger briefly after the ritual ends if still in range.

Audio:

- music.mp3 and sound.wav play only within audio.range (default 20m).

- sound.wav is intentionally quieter than the main track.

- Volume rises at climax for players still in range.

- Leaving the area stops audio; re-entering restarts it.

Visual effects (animals, eagle, particles) sync for all clients; rain and audio are local.

CONFIGURATION (config.lua)

--------------------------

Config.Framework

auto, rsg, or vorp

Config.Language

en or pt (controls notifications, prompts, and NUI text)

Config.Rituals

Each ritual key (indigena, lua, ancestral) has its own:

- item Kit item name

- label Display name

- offerings Required items and amounts

- timings Phase delays and total duration

- audio Music, ambient sound, volumes, hearing range

- rain Local weather settings

- eagle Spirit eagle flight and landing

- animal Spirit buffalo spawn behavior

- particles Smoke, fire, energy effects

- playerAnims Dance animations for participants

- reward Items given to nearby players when ritual ends

Global settings:

Config.InteractDistance Distance to interact with totem

Config.PlacementDistanceMax Max distance to place totem

Config.CornerPropModel Corner marker prop model

Config.CornerPropCount Number of corner markers (default 4)

Config.CornerPropRadius Radius from center for corners

RULES AND LIMITATIONS

---------------------

- Only one ritual can be active on the entire server at a time.

- Only the owner (who placed the totem) can open offerings, start, or remove it.

- Totem cannot be removed while ritual is running.

- Ritual kit item is consumed when the totem is successfully placed.

- Offering items are removed from inventory when placed.

- Ritual state is saved in database table mx_indigena (persists across restarts).

SUPPORT

-------

Discord: https://discord.gg/JBJUyJQfcf