Enhanced – Faction System

Based on Lilith Faction System, update and improved for rAthena version > 2020 with yaml and ryml support.

Main Features:

• Faction versus Faction wars allowed only on FvF maps ( Min.lvl -> fvf_min_lvl: 55 )
• Faction chan
• Custom aura effects ( max is 3 by default, but you can increase it )
• Aura can displaying for unit types in faction.conf: NPCs, Monsters, Pets, etc…( not only for Player )
• Support of Functor Color Nick and Function Aura for players if you already have them
• Monster and other can change own base status ( race, element… )
• If faction have Undead race or status faction members in this function can heal themselves ( if it allowed in faction_db.txt )
• NPC shops can sell items to different factions at different prices.
• Now saving faction leader and relics of each faction.
• Multi – alliance support.
• Voting system ( voting for faction leader ).
• Relics support.
• Logging Faction chat.
• FVF mapflag and mapcell
• Stats bonus for each faction
• Special aura effect (like for Guild leader) linked to a skill
• Special icons that you can set by faction, race

Faction db features

#####################################################################
# – Id Instance ID.
# Name Faction Name: Faction Name
# PlayerName Faction Player name: Player’s name on FvF maps
# HomeMap Location: Faction Location (home)- Map Name where players start.
# HomeX X Coordinate where players start.
# HomeY Y Coordinate where players start.
# Race Formless, Undead, Brute, Plant, Insect,
# Fish, Demon, Demi-Human, Angel, Dragon
# Element Neutral, Water, Earth, Fire, Wind,
# Poison, Holy, Dark, Spirit, Undead
# ElementLevel lvl: 1 ~ 4
# Size Small, Medium, Large
# rpRace Roleplay Race
# HairColor Default Hair color
# HairStyle Default Hair style
# ClothColor Default Cloth color
# MsgColor Color of messages (0xRRGGBB): Ex. 0xFF0000 – red
# FunctorAura Color of Aura (0xRRGGBB): Ex. 0xFF0000 – red. Only work if you have Functor Aura feature
# Aura:  Effect see doc/effect_list.txt
# FunctorNick color_nicks_group_id set in color_nicks.txt. Only work if you have Color Nicks by Functor
# Script Script Bonus for each faction
# LeaderAuraBonus Script bonus for faction aura around faction leader like guild master’s aura
# Alliance:
# Faction Alliance Faction ID
###########################################################################

Battle config features

// What unit type can receive faction status (race, element…)
// 539 = PC(1) + MOB(2) + HOM(8) + MER(16) + ELEM(512) (Default)

// Can faction monsters attack non-faction monsters?

// Faction chat settings (only on FvF maps)
// 1 = Colored messages
// 2 = Hide names from other factions (except Alliance)
// 4 = Hide names for your own faction (and ally)
// 7 = all options

// Start FvF mapflag on all maps?

// Display HP bar in the same factions?

// Additional HP Rate e.g 10 = 10% Additional than ‘hp_rate’ (Works only in FvF Mapflag)

// Additional SP Rate e.g 10 = 10% Additional than ‘sp_rate’ (Works only in FvF Mapflag)

// Damage adjustment settings, these follow the same logic as their WoE counterparts (see guild.conf)

// Change this to define the minimum level players can fight in FvF

// Faction Points System – If you kill 1 member of another faction you will obtain 1 point
// Only on FvF mapflag area
// 0 Disabled (Default)
// 1 IP BASED – Prevent Any Abuse if killed by the same IP
// 2 GEPARD BASED – Prevent Any Abuse if killed by the same unique id
// 3 Both options

// Display unit’s faction size? (visual effect)
// 0 – disable
// 1 – only FvF maps (Default)
// 2 – everywhere

// Unit type for setting ‘fvf_visual_size’. (Note 3 except Mercenaries)
// 527 = PC(1) + MOB(2) + PET(4) + HOM(8) + ELEM(512) (Default)

// Display faction aura?
// 0 – disable
// 1 – only FvF maps (Default)
// 2 – everywhere

// What unit type can receive ‘faction_aura_settings’. (Note 3)
// 671 = PC(1) + MOB(2) + PET(4) + HOM(8) + MER(16) + NPC(128) + ELEM(512) (Default)

// What unit type can display ‘enemy’ over head?
// 539 = PC(1) + MOB(2) + HOM(8) + MER(16) + ELEM(512) (Default)
// 0 = disable swords over head and enable faction icons (see db/faction_emblem/)

// Faction leader message color ( @factionannounce <message> )
// 0xRRGGBB

// Should the player’s dye change own cloth color?
// 0 – disable
// 1 – only FvF maps (Default)
// 2 – everywhere

// Should the player’s dye change own hair color?
// 0 – disable
// 1 – only FvF maps (Default)
// 2 – everywhere

// Should the player’s dye change own hair style?
// 0 – disable
// 1 – only FvF maps (Default)
// 2 – everywhere

// Can the faction with race or element Undead/Demon use healing skills to oneself ? (Note 1)
// 0 – disable
// 1 – Only same faction members (Default)
// 2 – Alliance faction members

// What unit type can receive ‘faction_heal_settings’. (Note 3)
// 19 = PC(1) + MOB(2) + MER(16) (Default)

// Notification when player warps to a FvF zone, not compatible with faction_chat_settings config
// 0 – Don’t show any kind of notification
// 1 – Show a message in chat
// 2 – Show a broadcast message (to player only)
// 3 – Both options

// Notification color (RGB) – Only for message in chat, broadcast can’t use this
// Example: 0xFF0000 = Red

// Faction party settings:
// 0 – Allow members to talk with NPC in same faction (Default)
// 1 – Allow members from alliance to talk with NPC
// 2 – No restrictions

// Faction party settings:
// 0 – Allow members in same faction to join same party (Default)
// 1 – Allow faction members from alliance to join same party
// 2 – No restrictions

// Faction guild settings:
// 0 – Allow members in same faction to join same guild (Default)
// 1 – Allow faction members from alliance to join same guild
// 2 – No restrictions

// Faction trade settings:
// 0 – Allow members in same faction to trade (Default)
// 1 – Allow faction members from alliance to trade
// 2 – No restrictions

// Max Discount & overcharge settings ( percentage )
// By default: max discount is -100%, overcharge is 100%