VIP Plugins MineClans - The New Factions Plugin v1.1.6

The MineClans Factions Plugin offers a robust, efficient, and user-friendly experience for faction management within Minecraft servers. Designed with modern tools and seamless integration, this plugin empowers players to create, manage, and grow their own factions with ease.

Requirements:​

• PlaceholderAPI
• Vault

Features:​

• Faction Creation & Management: Players can create, disband, and manage their factions efficiently with commands like /create, /disband, /rename, and more.
• Comprehensive Commands: Access a full suite of commands for all faction activities—invite players, manage relations (ally, enemy), set faction homes, deposit and withdraw from faction banks, and more.
• Custom Faction Chat: Facilitate communication within factions using dedicated chat commands to enhance coordination.
• Faction Events: Take part in special faction events, offering rewards and enhancing gameplay.
• High Performance: Built to work seamlessly with your Minecraft server, supporting both large and small communities.
• MySQL Database Support.
• SQLite Database Support.
• Redis Database Support.

Commands:​

• /factions create — Create a new faction
• /factions disband — Disband an existing faction
• /factions who — Display faction information
• /factions invite — Invite players to your faction
• /factions join/leave — Join or leave a faction
• /factions chat — Enable faction-only chat
• /factions claim/unclaim/claims/tpclaim — Manage claims for your Faction
• And many more, ensuring all aspects of faction life are covered.

Placeholders

• %factions_leaderboard_<number>%
• %factions_event_name%
• %factions_event_time_left%
• %factions_name%
• %factions_displayname%
• %factions_prefix%
• %factions_online%
• %factions_owner% %factions_balance%
• %factions_members%
• %factions_focus_name%
• %factions_focus_online%

Configuration Files:​

YAML:
weights:
kill: 0.5
money: 0.01
member_count: 0.1
events_won: 0.1

buffs:
custom-buffs:
speed:
display_name: "&b&lSpeed Buff"
lore:
- "&7Give speed to your faction members"
effects:
- "SPEED,0,60"
price: 10
slot: 10
material: SUGAR

mining_speed:
display_name: "&a&lMining Speed Buff"
lore:
- "&7Increase mining speed for your faction members"
effects:
- "FAST_DIGGING,0,60"
price: 15
slot: 12
material: "IRON_PICKAXE"

increase_damage:
display_name: "&c&lIncrease Damage Buff"
lore:
- "&7Increase damage for your faction members"
effects:
- "INCREASE_DAMAGE,0,60"
price: 20
slot: 14
material: IRON_SWORD

protection:
display_name: "&9&lProtection Buff"
lore:
- "&7Increase protection for your faction members"
effects:
- "DAMAGE_RESISTANCE,0,60"
price: 25
slot: 16
material: IRON_CHESTPLATE

regeneration:
display_name: "&d&lRegeneration Buff"
lore:
- "&7Regenerate health for your faction members"
effects:
- "REGENERATION,0,60"
price: 30
slot: 30
material: GOLDEN_APPLE

health_boost:
display_name: "&e&lHealth Boost Buff"
lore:
- "&7Increase health for your faction members"
effects:
- "HEALTH_BOOST,0,60"
price: 35
slot: 32
material: REDSTONE_BLOCK

events:
interval: 25 # minutes
custom-events:
diamond-mining-competition:
name: "Diamond Rush"
description: "Mine 50 diamonds before other factions to claim victory!"
objectives:
diamond_mine: 50
rewards:
commands:
- "give {player} diamond_block 1"
deposit: 5
faction-warfare:
name: "Faction Warfare"
description: "Eliminate 25 enemy faction members to dominate the battlefield!"
objectives:
faction_kill: 25
rewards:
commands:
- "give {player} golden_apple 1"
deposit: 5
ore-extraction-challenge:
name: "Ore Extraction Race"
description: "Extract 500 blocks of ore faster than any other faction!"
objectives:
block_mine: 500
rewards:
commands:
- "give {player} emerald 1"
deposit: 5
monster-slaying-competition:
name: "Monster Hunt"
description: "Slay 250 mobs to prove your faction's combat prowess!"
objectives:
mob_kill: 250
rewards:
commands:
- "give {player} enchanted_golden_apple 1"
deposit: 5
bountiful-harvest-challenge:
name: "Bountiful Harvest"
description: "Harvest 1000 crops before other factions to reap the rewards!"
objectives:
crop_harvest: 1000
rewards:
commands:
- "give {player} pumpkin_pie 1"
deposit: 5
timber-felling-competition:
name: "Timber Felling Challenge"
description: "Gather 2000 logs faster than any other faction!"
objectives:
wood_mine: 2000
rewards:
commands:
- "give {player} dark_oak_log 1"
deposit: 5
anglers-tournament:
name: "Angler's Tournament"
description: "Catch 400 fish before your rivals to claim the title of master angler!"
objectives:
fishing: 400
rewards:
commands:
- "give {player} cooked_salmon 1"
deposit: 5

mysql:
enabled: true
url: jdbc:mysql://localhost:3306/database
username: root
password: password
YAML:
event:
start:
title: "&aStart!"
subtitle: "&e%description%"
end:
title: "&cEvent Finished!"
subtitle: "&eWinner: %winnerName%"
default_winner: "No Winner"

menus:
personal_bank:
title: "&aPersonal Bank"
deposit:
name: "&aDeposit"
lore: "&7Click to deposit money"
withdraw:
name: "&cWithdraw"
lore: "&7Click to withdraw money"
close:
name: "&cClose"
lore: "&7Click to close the menu"
deposit_withdraw:
deposit:
title: "&aDeposit Money"
percentages:
25:
name: "&aDeposit 25%"
lore: "&7Click to deposit 25% of your balance"
50:
name: "&aDeposit 50%"
lore: "&7Click to deposit 50% of your balance"
100:
name: "&aDeposit 100%"
lore: "&7Click to deposit 100% of your balance"
specific:
name: "&eSpecific Amount"
lore: "&7Enter specific amount to deposit"
withdraw:
title: "&cWithdraw Money"
percentages:
25:
name: "&cWithdraw 25%"
lore: "&7Click to withdraw 25% of your balance"
50:
name: "&cWithdraw 50%"
lore: "&7Click to withdraw 50% of your balance"
100:
name: "&cWithdraw 100%"
lore: "&7Click to withdraw 100% of your balance"
specific:
name: "&eSpecific Amount"
lore: "&7Enter specific amount to withdraw"

factions:
open:
no_faction: "&cYou are not in a faction"
o_permission: "&cYou have no permission to open/close your faction"
faction_opened: "&b%player%&7 has set the faction status to &a&lOPEN"
faction_closed: "&b%player%&7 has set the faction status to &c&lCLOSED"
invites:
# Message shown when there are no invites received by the player
received:
none: "&cNo factions have invited you."
# Message for listing received invites with placeholders for the invites list
list: "&6Invites (%inviteCount%): &e%invites%"

# Message shown when the player's faction hasn't sent any invites
sent:
none: "&cYour faction has not sent any invites."
# Message for listing sent invites with placeholders for faction name and invite list
list: "&6Sent by &e%faction% &7(%inviteCount%): &e%invites%"
announcement:
join: "&7Faction Announcement: %announcement%"
title: "&aAnnouncement Updated"
subtitle: "&7New: %announcement%"
success: "&aThe announcement for your faction has been updated successfully!"
no_permission: "&cYou do not have permission to update the announcement."
no_faction: "&cYou are not part of any faction."
invalid_announcement: "&cThe announcement provided is invalid or empty. The announcement was now cleared."
discord:
invalid_discord: "&cThe Discord link you provided is invalid. Please try again with a valid link. Discord link was just resetted to be empty."
no_permission: "&cYou do not have permission to set the Discord link for your faction."
no_faction: "&cYou are not part of a faction."
title: "&aFaction Discord Set"
subtitle: "&7The Discord link has been updated."
success: "&aSuccessfully updated the Discord link for your faction."
help:
header: "&7&m-------------------------\n&c&lFaction Help &7(Page {page}/{maxPages})\n "
line: "&f{command} &7> {description}"
footer: "&7 \n&r &cTo view more, use '&f/f help <page#>&c'\n&7&m-------------------------"
page: "&cInvalid page number. Showing page 1."
usage:
create: "Create a new faction"
accept: "Accept a pending invitation"
leave: "Leave your current faction"
home: "Teleport to your faction home"
sethome: "Set your faction’s home at your location"
focus: "Focus a faction and get all their details"
unfocus: "Cancel the faction focus"
deposit: "Deposit money into faction balance"
withdraw: "Withdraw money from faction balance"
carry: "Show who contributed the most to the faction"
who: "Display faction information"
invite: "Invite a player to your faction"
uninvite: "Revoke an invitation"
invites: "List all open invitations"
kick: "Kick a player from your faction"
announcement: "Set your faction’s announcement"
promote: "Promote a player to the next rank"
demote: "Demote a player to the previous rank"
open: "Open the faction"
rename: "Rename your faction"
setdiscord: "Change your faction discord"
disband: "Disband your faction"
displayname: "Set a custom display name for your faction"
chat: "Toggle faction chat mode"
tl: "Share your current location with your faction"
friendlyfire: "Toggle friendly fire in your faction"
chest: "Access your faction’s chest"
enemy: "Declare another faction as enemy"
neutral: "Set relation to another faction as neutral"
ally: "Form an alliance with another faction"
melody: "Play a melody within the faction"
buff: "Activate faction buffs"
events: "View or participate in faction events"
list: "List all factions on the server"
transfer: "Transfer leadership of the faction to another player"
buffs:
no_money: "&cYou do not have %price% to purchase %buff%&c."
activated: "&aYou activated&e %buff%&a%activated_price%&a."
activated_price: " for &6$%price%"
activated_other:
title: "&a&lBuff Active"
subtitle: "&7%player% activated &b%buff%&7."
msg: "&b%player%&a activated &e%buff%&a for all your Faction."
no_faction: "&cYou are in no faction."
expired:
title: "&c&lBuff Expired"
subtitle: "&b%buff%&7 has expired."
msg: "&e%buff%&c has expired."
kill:
title: "&a&lKILL"
subtitle: "You killed &b%killed%&r!"
no_reward_title: ""
no_reward_subtitle: "&cNo rewards for kill."
chat:
prefix: "&e[Faction] %player%: "
prefix_alliance: "&d[Alliance] [%faction%] %player%: "
faction: "&aFaction chat is currently on &l&2ENABLED&a."
alliance: "&aFaction chat is currently on &l&dALLIANCE&a."
disabled: "&aFaction chat is currently on &l&cDISABLED&a."
not_in_faction: "&cYou’re not in a faction. Join one to enable chat features."
unknown_error: "&cAn unknown error occurred."
withdraw:
success_menu: "&aYou have withdrawn %amount% (%percentage%%) from your faction's balance."
success: "&aWithdrawal of $%amount% successful!"
not_in_faction: "&cYou are not in a faction."
no_permission: "&cYou have to be COLEADER to withdraw funds."
insufficient_funds: "&cYour faction does not have enough funds to withdraw $%amount%."
error: "&cAn error occurred while processing your withdrawal. Please try again later."
invalid_amount: "&cInvalid amount entered: $%amount%"
no_economy: "&cVault is not installed. No economy system present."
who:
format: |-
&7&m-------------------------
&c %faction_name%&7 [%online_count%/%member_count%]&e HQ: &f%hq_coords%&8 [%invite_status%]
%members%
%announcement%
%discord%
&e Balance:&a $%balance%&e Kills:&c %kills%&e Power:&b %power%
&e Founded At:&f %founded_date%
&7&m-------------------------
leader: "&e Leaders:&7 %members%"
coleader: "&e Co-Leaders:&7 %members%"
moderator: "&e Moderators:&7 %members%"
recruit: "&e Recruits:&7 %members%"
member: "&e Members:&7 %members%"
announcement: "&7 %announcement%"
discord: "&e Discord:&7 %link%"
invalid_faction: "&cThe faction is not valid."
not_in_faction: "&cYou are not in a faction."
uninvite:
title_uninvited_other: "&cUninvited Player"
subtitle_uninvited_other: "You uninvited %player% from the faction."
null_name: "&cUsage: /factions uninvite <player>"
no_faction: "&cYou have no faction."
no_permission: "&cYou are not MODERATOR to uninvite."
not_invited: "&cPlayer is not invited."
success: "&aPlayer uninvited successfully."
player_not_found: "&cPlayer not found."
transfer:
member_not_found: "&cThe specified player is not a member of your faction."
not_owner: "&cYou must be the faction owner to transfer ownership."
no_faction: "&cYou are not in a faction."
null_name: "&cYou must specify the name of the new owner."
success: "&aOwnership of the faction has been successfully transferred to %new_owner%."
unknown_error: "&cAn unknown error occurred."
tell_location:
message: "&7My location is %world%: %x%, %y%, %z%"
success: "&aLocation shared with your faction."
not_in_faction: "&cYou are not in a faction."
error: "&cAn error occurred while sending the message."
unknown_error: "&cAn unknown error occurred."
sethome:
no_permission: "&cYou do not have permission to set home."
success: "&aHome set successfully."
error: "&cAn error occurred while setting home."
not_in_faction: "&cYou are not in any faction."
rename:
already_exists: "&cThe faction name already exists."
cooldown: "&cWait 60 seconds before changing the name again."
not_in_faction: "&cYou are not in a faction."
no_permission: "&cYou are not LEADER of this faction."
success: "&aFaction name successfully changed."
null_name: "&cYou have to enter a name."
error: "&cThe name is not valid."
list:
header: "&6Faction List:"
entry: "&e%faction% &7(%members%/%max_members%) [Level %faction_level%]"
footer: "&6You are currently on Page &e%current_page%&6/&e%total_pages%&6."
invalid_page: "&cInvalid page number. Please try again."
melody:
usage: "&cUsage: /f melody <melody>"
available: "&cAvailable melodies: %melodies%"
invalid: "&cInvalid melody name."
promote:
superior_rank: "&cThe player is higher or same rank than you."
player_not_found: "&cPlayer not found."
not_in_faction: "&cPlayer is not in your faction."
no_permission: "&cYou require LEADER to promote/demote players."
cannot_promote: "&cYou cannot promote this player anymore."
cannot_promote_to_leader: "&cCannot promote player to leader."
success: "&aPlayer promoted successfully."
relation_set:
invalid_relation_type: "&cInvalid relation type: %relation_type%"
no_faction: "&cYou are not in a faction."
same_faction: "&cYou cannot set relation towards your own faction."
other_faction_not_found: "&cFaction %other_faction% not found."
already_relation: "&cYou are already &b%relation_type%&c towards &b%other_faction%"
success: "&aYour faction is now &b%relation_type%&a towards &b%other_faction%&a."
success_other: "&b%other_faction%&c is now &b%relation_type%&c towards you."
now_enemies: "&cYou are enemies."
now_allies: "&aYou are now allies."
unexpected_error: "&cAn unexpected error occurred."
invite:
title_invited_other: "&eInvited Player"
subtitle_invited_other: "&aYou invited %player% to your faction."
usage: "&cUsage: /factions invite <player>"
no_faction: "&cYou have no faction."
no_permission: "&cYou require rank MODERATOR to do this."
member_exists: "&cPlayer is already a member."
already_invited: "&cPlayer is already invited."
success: "&aPlayer invited successfully."
invite_message: "&aYou have been invited to join a &b%faction%&a."
player_not_found: "&cPlayer not found."
join:
title: "&aJoined Faction"
subtitle: "&fYou joined the faction %faction%."
already_in_faction: "&cYou are already in a faction."
not_invited: "&cYou are not invited to this faction."
no_faction: "&cNo faction with this name."
usage: "&cUsage: /factions join <faction>"
success: "&aYou have joined the faction %faction%."
kick:
success: "&cPlayer %player% has been kicked from the faction."
not_in_faction: "&cYou are not in a faction."
not_moderator: "&cYou are not moderator of the faction."
player_not_found: "&cThe specified player is not a member of your faction."
superior_rank: "&cYou cannot kick a player with a higher or equal rank."
not_yourself: "&cYou cannot kick yourself."
error: "&cAn error occurred while kicking the player."
leave:
title: "&cLeft Faction"
subtitle: "&fYou left the faction %faction%."
faction_owner: "&cYou are the owner. Disband your faction or transfer ownership instead."
no_faction: "&cYou are not in a faction."
success: "&cYou left your faction."
focus:
success: "&aSuccessfully focused on faction: %faction%"
not_in_faction: "&cYou are not in a faction."
faction_not_found: "&cFaction '%faction%' not found. Cleared focus."
no_permission: "&cYou need to be RECRUIT to focus on factions."
same_faction: "&cYou are trying to focus your own faction."
error: "&cAn unexpected error occurred."
friendly_fire:
enabled: "&aFriendly fire is now enabled in your faction."
no_permission: "&cYou are not COLEADER of this faction."
disabled: "&aFriendly fire is now disabled in your faction."
not_in_faction: "&cYou are not in a faction."
error: "&cAn error occurred while toggling friendly fire."
unknown_error: "&cAn unknown error occurred."
home:
success: "&aTeleporting home..."
no_home_set: "&cYou haven't set a home yet."
error: "&cAn error occurred while teleporting home."
not_in_faction: "&cYou are not in a faction."
disband:
title: "&cDisbanded Faction"
subtitle: "&fYou disbanded the faction %faction%."
no_permission: "&cYou have to be LEADER to disband the faction."
no_faction: "&cYou have no faction."
success: "&aDisbanded faction."
displayname:
different_name: "&cThe faction display name cannot be different from the original name."
not_in_faction: "&cYou are not in a faction."
success: "&aFaction name successfully changed."
null_name: "&cYou have to enter a name."
error: "&cThe displayname is not valid."
event:
no_permission_start: "&cYou do not have permission to start events."
no_permission_end: "&cYou do not have permission to end events."
start_success: "&aThe event %event% has started!"
no_event_scheduled: "&cNo event is scheduled to start."
end_success: "&aThe event %event% has ended!"
no_event_running: "&cNo event is currently running."
not_in_faction: "&cYou are not part of any faction."
no_events_scheduled: "&cNo events are scheduled at the moment."
current_event: "&6Current Event: &e%event%\n&6Time Remaining: &e%time%"
faction_progress: "&6Faction Progress:\n"
event_objective: "&e%type%: &a%progress% &f%percentage%"
next_event: "&6Next Event: &e%event%\n&6Starts In: &e%time%"
demote:
superior_rank: "&cThe player is higher or same rank than you."
player_not_found: "&cPlayer not found."
not_in_faction: "&cPlayer is not in your faction."
no_permission: "&cYou require LEADER to promote/demote players."
cannot_demote: "&cCannot demote player."
success: "&aPlayer demoted successfully."
deposit:
success_menu: "&aYou have deposited %amount% (%percentage%%) to your faction's balance."
success: "&aDeposit of $%amount% successful!"
not_in_faction: "&cYou are not in a faction."
no_permission: "&cYou do not have permission to deposit funds."
no_money: "&cYou have insufficient funds."
error: "&cAn error occurred while processing your deposit. Please try again later."
invalid_amount: "&cInvalid amount entered: $%amount%"
no_economy: "&cVault is not installed. No economy system present."
create:
title: "&aCreated Faction"
subtitle: "&fYou created the faction %faction%."
usage: "&cUsage: /factions create <factionName>"
success: "&aFaction %faction% created successfully!"
error: "&cAn error occurred while creating the faction."
already_have_faction: "&cYou already have a faction. Disband it or leave first."
faction_exists: "&cThe faction already exists."
chest:
success: "&aYou have opened the faction chest."
not_in_faction: "&cYou are not in a faction."
no_permission: "&cYou need to be MEMBER to open the faction chest."
error: "&cAn error occurred while trying to open the chest."
unknown_result: "&cUnknown result."
usage: "&cUsage: /factions <create|disband> <factionName>"
no-console: "&cYou cannot use this command from console."

Previews:​

With efficient asynchronous task management, MineClans Factions Plugin ensures high performance and minimal server impact, even during peak activity.​