MainMC 插件是 Essentials 插件的替代品，它具有更多功能，但体积仅为后者的十分之一。它旨在改善 Minecraft 服务器环境，修复了 Essentials 和许多其他知名插件中存在的多个错误。

---

📌 插件特性

• 100% 可定制和翻译的消息
• 独立的经济系统 (可以禁用以使用 Vault)
• 比传统方式更高级的 Ban-IP 系统
• 修复了 Essentials 中的 10 多个错误
• 多个用于用户管理的管理员命令
• 完整的制裁存档系统
• 允许对其他用户使用不同命令 (在 Essentials 中不可能)
• 高级邮件系统
• 可以在 Kits 中实现命令和 Kit 别名
• 集成的 Spawn-TP
• 更多自定义的告示牌
• 集成的聊天公告 (可以停用)
• 集成的 ItemRestricted 功能
• 6 个新的保护系统，防止恶意破坏或漏洞利用
• 可以在游戏中创建 Kits
• 可以创建自定义书写书籍
• 可以通过 GUI 管理 Kits
• 可以通过 GUI 管理 Warps，可在游戏中自定义
• 可以通过使用 Addon 的 GUI 管理经济
• 可以使用 MainMC Economy Addon 使用 Vault
• 可以计算总在线玩家时间
• 在 PvP 中集成的 CombatLog 系统
• 可以以银行支票形式提取资金
• 通过注册的命令查找插件

📦 安装 Economy Addon (使用 Vault)

1. 将 MainMC 放入插件文件夹并启动服务器
2. 在 config.yml 的 Economy 部分将 addon enabled 设置为 true
3. 将 MainMC Economy 插件和 Vault 放入插件文件夹
4. 启动服务器，Vault Economy Addon 即可使用

---

📜 命令列表

以下是 MainMC 插件的所有可用命令列表：

/MainMC main command
/MainMC reload reload plugin
/MainMC help show list of commands
/MainMC findpl <cmd> show list of plugin that have this command
/gmc <player> set player gamemode to creative
/gms <player> set player gamemode to survival
/gma <player> set player gamemode to adventure
/gm <gm> <player> set player gamemode
/vanish <player> set player to invisible
/give <player> <id> <amount> [enchant:level] [name:customname] give items to a player
/item <id> <amount> get items
/enchant <enchant> <level> enchant item in your hand
/kick <player> <motivation> kick a player form server
/kickall <motivation> kick all players online
/xp show <player> show player xp value
/xp give <player> <level> give xp value to a player
/xp set <player>  <level> set new xp value to a player
/feed <player>  feed hunger bar to a player
/heal <player> set healthy to a player
/god <player> set a player invincible
/hat <player>  set a block in your hand as hat to a player
/fly <player> set fly mod to a player
/speed <walk/fly> <1-10> <player> set speed fly or walk to a player
/walkspeed  <1-10> <player> set walk speed to a player
/flyspeed <1-10> <player> set fly speed to a player
/day set day in all worlds to a player
/night set night in all worlds
/sun set weather to sunny
/storm set weather to stormy
/thunder set weather to thundering
/repair hand reapir item in your hand
/repair all  reapir all items in your inventory
/workbench Open the workbench
/me send a messagga to all serve
/clear <player> clar a player inventory
/tp <player> <toplayer> teleport to a player
/tphere  <player> teleport a player to you
/tpall <player> teleport all players to player
/tppos <x> <y> <z> <player> teleport a player to a specific location
/tptoggle <player> enable/disable teleport request to a player
/invsee <player> see a player inventory
/endersee <player> see a player enderchest
/broadcast send a broadcast messagge
/kill <player> kill a player
/suicide kill your self
/getpos <player> get a player location
/spawner  <mobtype> set mob spawner type
/mobkill <mobtype/all> kill mobs in the worlds
/thor <player> thunderstruck a player
/list see list of all players online
/afk <player> <cause> set a player afk
/helpstaff  <message> send a message to staff
/msg <player> <message> send private message to a player
/reply <message> reply to a private message
/back go to your last location
/tpa <player> send teleport request to a player
/tpaccept accept a teleport request
/tpdeny reject a teleport request
/tpahere request to a player to teleport to you
/setspawn set spawn location
/spawn go to spawn location
/setwarp <warp> set a warp location
/warp <warp> go to a warp
/warps see all avaible warps
/delwarp delete an existing warp
/kit <kit> <player> give a kit to a player
/kits see all avaible kits
/nick <nickname/off> <player> set a custom display name in chat
/realname <nickname> see real username form custom nickname
/ignore <player> <playertoignore> ignore a player when write in chat
/ignores <player> see list of all players ignored
/socialspy <player> see all private message
/mail send  <player> <message> send a mail to a player
/mail read read your mails
/mail clear dlete your mails
/spymail show admin commands mail
/motd see main motd
/sethome  <homename> set an home
/home <homename> go to an home
/delhome <homename> delete an home
/adminhome show admin commands home
/mute <player> <motivation> mute a player
/unmute <player> allow to write in chat to a player
/tempmute <player> <m/h> <motivation> mute a player for a specific time in minutes or hours
/ban <player> <motivation> ban a player from server
/unban <player> unban a player from server
/unbanall unban all banned players
/tempban <player> <h/d/y> <motivation> ban a player for a specific time in hours, deays or years
/world <worldname> <player> teleport a player to a world
/top <player> teleport a player to top block location
/createjail <name> create a jail in your location
/jails see all avaible jails
/deljail <name> delete an existing jail
/jail <player> <jail> set a player in a specific jail
/unjail <player> remove a player to jail
/lookup <player> check if a player is banned or muted
/banip <player/IP> <motivation> ban an IP or a player IP
/unbanip <player/IP> unban an ip or a player IP
/seen <player/IP> see all player IP or all users than have the same IP
/setlockaccount <keyword> set a keyword to unlock your account on IP change
/unlockaccount <keyword> if you change IP you can unlock your account
/history <player> see al bans, kicks and mutes of a player
/balance <player> see money balance
/pay <player> <amount> pay money to a player
/eco give <player> <amount> give money to a player
/eco take <player> <amount> remove money to a player
/eco set <player> <amount> set new money balance to a player
/firstlogin <player> to get when player join the first time in date.
/kitcreator create <kit> create a kit in game.
/kitcreator setdelay <kit> <delay> set a kit delay.
/kitcreator setalias <kit> <kit alias> set a kit as alias in an other kit.
/kitcreator setcmd <kit> <command> add command to a kit.
/kitcreator delete <kit> delete an existing kit.
/book see custom book list
/book <book> get a custom book
/book <book> <player> give a custom book to a player
/skull <owner> <player> give a custom skull to a player
/ping <player> see player ping
/ptime <player> see online player time
/lastlocation <player> get last player location
/icadd <console/player> <command> add command to your item in hand
/burn <player> burn a player
/ext <player> clear fire ticks
/nightvision <player> toggle nightvision
/near <radius> <player> get players list in a specific radius
/withdraw <amount> withdraw money as bankcheck
/fireball launch fireballs
/compact compact minerals to blocks

---

🔑 权限列表

以下是 MainMC 插件的所有权限节点及其描述：

• main.reload - 重新加载插件配置的权限
• main.mainmc - 显示帮助命令的权限
• main.gamemode - 更改游戏模式的权限
• main.gamemode.other - 更改其他玩家游戏模式的权限
• main.give - 给予物品的权限
• main.vanish - 隐身的权限
• main.vanish.other - 使其他玩家隐身的权限
• main.enchant - 附魔手中物品的权限
• main.enchant.other - 附魔其他玩家手中物品的权限
• main.kick - 踢出玩家的权限
• main.xp - 使用 XP 命令的权限
• main.xp.show - 显示玩家 XP 的权限
• main.xp.set - 设置玩家 XP 值的权限
• main.xp.give - 给予玩家 XP 等级的权限
• main.feed - 使用 feed 命令的权限
• main.feed.other - 对其他玩家使用 feed 命令的权限
• main.heal - 使用 heal 命令的权限
• main.heal.other - 对其他玩家使用 heal 命令的权限
• main.god - 切换上帝模式的权限
• main.god.other - 激活/禁用其他玩家上帝模式的权限
• main.hat - 将手中的方块设置为帽子的权限
• main.hat.other - 将手中的方块设置为其他玩家帽子的权限
• main.fly - 切换飞行模式的权限
• main.fly.other - 切换其他玩家飞行模式的权限
• main.speed - 使用 speed 命令的权限
• main.time - 更改所有世界时间的权限
• main.weather - 更改所有世界天气的权限
• main.repair - 使用 repair 命令的权限
• main.repair.hand - 修复手中物品的权限
• main.repair.all - 修复背包中所有物品的权限
• main.workbench - 以背包形式打开工作台的权限
• main.me - 使用 /me 命令的权限
• main.clear - 清空自己背包的权限
• main.clear.other - 清空其他玩家背包的权限
• main.tp - 传送到其他玩家的权限
• main.tp.other - 将一个玩家传送到另一个玩家的权限
• main.tphere - 将其他玩家传送到你身边的权限
• main.invsee - 查看其他玩家背包的权限
• main.invsee.interact - 与其他玩家背包交互的权限
• main.enderchest - 以背包形式打开末影箱的权限
• main.enderchest.other - 查看其他玩家末影箱的权限
• main.enderchest.other.interact - 与其他玩家末影箱交互的权限
• main.broadcast - 使用 broadcast 命令的权限
• main.kickall - 踢出所有在线玩家的权限
• main.kill - 杀死玩家的权限
• main.tpall - 将所有在线玩家传送到你身边的权限
• main.tpall.other - 将所有玩家传送到一个玩家身边的权限
• main.tppos - 传送到特定位置的权限
• main.tppos.other - 将玩家传送到特定位置的权限
• main.tptoggle - 允许或拒绝传送到你的权限
• main.tptoggle.other - 允许或拒绝传送到一个玩家的权限
• main.getpos - 查看你的位置的权限
• main.getpos.other - 查看其他玩家位置的权限
• main.spawner - 更改刷怪笼类型的权限
• main.thor - 用雷击打其他玩家的权限
• main.list - 查看所有在线玩家列表的权限
• main.list.viewall - 查看所有在线玩家列表 (包括隐身玩家) 的权限
• main.afk - 使用 /afk 命令的权限
• main.afk.other - 设置其他玩家为 AFK 的权限
• main.afk.bypasskick - 在 AFK 踢出时间后保持在线的权限
• main.helpstaff - 使用 helpstaff 命令的权限
• main.helpstaff.receive - 查看发送给 helpstaff 的消息的权限
• main.msg - 发送私信的权限
• main.reply - 回复私信的权限
• main.back - 使用 back 命令的权限
• main.tpa - 使用 tpa 命令的权限
• main.tpahere - 使用 tpahere 命令的权限
• main.tpaccept - 接受传送请求的权限
• main.tpdeny - 拒绝传送请求的权限
• main.setspawn - 设置出生点的权限
• main.spawn - 使用 /spawn 命令的权限
• main.warps - 使用 warp 命令的权限
• main.warp.list - 查看 warp 列表的权限
• main.warp - 使用 warp 命令的权限
• main.setwarp - 设置 warp 的权限
• main.delwarp - 删除 warp 的权限
• main.back.bypassdelay - 绕过 back 命令延迟的权限
• main.spawn.bypassdelay - 绕过 spawn 命令延迟的权限
• main.warps.bypassdelay - 绕过 warp 命令延迟的权限
• main.kit - 使用 kit 命令的权限
• main.kits - 查看 kit 列表的权限
• main.kits.bypassdelay - 绕过给予 kit 延迟的权限
• main.kits.other - 给予其他玩家 kit 的权限
• main.kit.<name> - 获取特定 kit 的权限
• main.nick - 设置自定义名称的权限
• main.nick.color - 使用昵称颜色的权限
• main.nick.format - 使用昵称格式的权限
• main.nick.magic - 在昵称中使用 &k 格式的权限
• main.nick.other - 设置其他玩家自定义昵称的权限
• main.realname - 使用 realname 命令的权限
• main.heal.bypassdelay - 绕过 heal 延迟的权限
• main.feed.bypassdelay - 绕过 feed 延迟的权限
• main.ignore.bypassignore - 绕过 ignore 的权限
• main.ignore - 使用 ignore 命令的权限
• main.ignore.other - 设置一个玩家被另一个玩家忽略的权限
• main.ignores - 查看被忽略玩家列表的权限
• main.ignores.other - 查看另一个玩家被忽略玩家列表的权限
• main.socialspy - 使用 socialspy 命令的权限
• main.socialspy.other - 切换其他玩家 socialspy 模式的权限
• main.mail - 使用 mail 命令的权限
• main.mail.send - 发送邮件的权限
• main.mail.read - 阅读邮件的权限
• main.mail.clear - 删除所有邮件的权限
• main.spymail - 使用 spymail 命令的权限
• main.spymail.read - 阅读其他玩家邮件的权限
• main.spymail.clear - 删除其他玩家所有邮件的权限
• main.spymail.clearindex - 删除其他玩家特定邮件的权限
• main.motd - 查看服务器 MOTD 的权限
• main.silentjoin - 绕过加入通知的权限
• main.silentjoin.vanish - 加入时隐身的权限
• main.silentquit - 绕过退出通知的权限
• main.untouchable - 绕过所有踢出、封禁、禁言的权限
• main.home - 使用 home 命令的权限
• main.sethome - 设置 home 的权限
• main.sethome.vip - 设置多个 home (VIP 数量) 的权限
• main.sethome.staff - 设置多个 home (Staff 数量) 的权限
• main.delhome - 删除 home 的权限
• main.delhome.other - 删除其他玩家 home 的权限
• main.home.other - 查看其他玩家 home 的权限
• main.adminhome - 使用 admin-home 命令的权限
• main.adminhome.teleport - 传送到其他玩家 home 的权限
• main.adminhome.set - 设置其他玩家 home 的权限
• main.mute - 使用 mute 命令的权限
• main.tempmute - 使用 tempmute 命令的权限
• main.unmute - 使用 unmute 命令的权限
• main.chat - 在聊天中写作的权限
• main.chat.color - 在聊天中使用颜色的权限
• main.chat.format - 在聊天中使用格式的权限
• main.chat.magic - 在聊天中使用 &k 格式的权限
• main.sign - 使用告示牌的权限
• main.sign.color - 在告示牌中使用颜色的权限
• main.sign.format - 在告示牌中使用格式的权限
• main.sign.magic - 在告示牌中使用 &k 格式的权限
• main.sign.disposal.create - 创建处理告示牌的权限
• main.sign.time.create - 创建时间告示牌的权限
• main.sign.weather.create - 创建天气告示牌的权限
• main.sign.enchant.create - 创建附魔告示牌的权限
• main.sign.warp.create - 创建 warp 告示牌的权限
• main.sign.kit.create - 创建 kit 告示牌的权限
• main.sign.heal.create - 创建 heal 告示牌的权限
• main.sign.repair.create - 创建 repair 告示牌的权限
• main.sign.gamemode.create - 创建游戏模式告示牌的权限
• main.sign.free.create - 创建免费告示牌的权限
• main.sign.buy.create - 创建购买告示牌的权限
• main.sign.balance.create - 创建余额告示牌的权限
• main.sign.sell.create - 创建出售告示牌的权限
• main.sign.disposal.use - 使用处理告示牌的权限
• main.sign.time.use - 使用时间告示牌的权限
• main.sign.weather.use - 使用天气告示牌的权限
• main.sign.enchant.use - 使用附魔告示牌的权限
• main.sign.warp.use - 使用 warp 告示牌的权限
• main.sign.kit.use - 使用 kit 告示牌的权限
• main.sign.heal.use - 使用 heal 告示牌的权限
• main.sign.repair.use - 使用 repair 告示牌的权限
• main.sign.gamemode.use - 使用游戏模式告示牌的权限
• main.sign.free.use - 使用免费告示牌的权限
• main.sign.buy.use - 使用购买告示牌的权限
• main.sign.balance.use - 使用余额告示牌的权限
• main.sign.sell.use - 使用出售告示牌的权限
• main.build - 建造的权限
• main.build.use - 与方块交互的权限
• main.build.place - 放置方块的权限
• main.build.break - 破坏方块的权限
• main.build.use.bypass - 绕过交互黑名单的权限
• main.build.place.bypass - 绕过放置黑名单的权限
• main.build.break.bypass - 绕过破坏黑名单的权限
• main.world - 传送到世界的权限
• main.world.other - 将玩家传送到世界的权限
• main.jail - 使用 jail 命令的权限
• main.jail.create - 创建监狱的权限
• main.jail.delete - 删除监狱的权限
• main.jails - 查看监狱列表的权限
• main.unjail - 释放玩家的权限
• main.lookup - 查看玩家信息的权限
• main.banip - 使用 banip 命令的权限
• main.unbanip - 使用 unbanip 命令的权限
• main.tempban - 使用 tempban 命令的权限
• main.ban - 使用 ban 命令的权限
• main.unban - 使用 unban 命令的权限
• main.seen - 查看 IP 信息的权限
• main.bypasscommands - 绕过命令黑名单的权限
• main.balance - 查看你的余额的权限
• main.balance.other - 查看玩家余额的权限
• main.eco - 使用 eco 命令的权限
• main.eco.give - 给予金钱的权限
• main.eco.set - 设置玩家新余额的权限
• main.eco.take - 从玩家余额中移除金钱的权限
• main.pay - 使用 pay 命令的权限
• main.firstlogin - 使用 firstlogin 命令的权限
• main.vanish.pvp - 在 PVP 中保持隐形的权限
• main.god.pvp - 在 PVP 中保持上帝模式的权限
• main.kits.creator - 在游戏中管理套件的权限
• main.book - 使用/book命令的权限
• main.book.other - 给予其他玩家书籍的权限。
• main.skull - 使用/skull的权限
• main.skull.other - 给予玩家骷髅头的权限
• main.ping - 使用/ping的权限
• main.ping.other - 查看其他玩家的ping的权限
• main.lastlocation.other - 查看其他玩家的最后位置的权限
• main.lastlocation - 查看你的最后位置的权限
• main.ptime - 查看你的在线时间的权限
• main.ptime.other - 查看其他玩家的在线时间的权限
• main.bypasscombat - 绕过战斗模式的权限
• main.item.command - 将命令设置为物品的权限
• main.burn - 燃烧玩家的权限
• main.ext - 使用ext命令的权限
• main.ext.other - 取消燃烧其他玩家的权限
• main.nightvision - 使用 /nv 命令的权限
• main.nightvision.other - 切换到其他玩家的夜视的权限
• main.near - 获取你所在位置附近的玩家的权限
• main.near.other - 获取其他玩家位置附近的玩家的权限
• main.withdraw - 提款权限
• main.withdraw.get - 使用银行支票
• main.fireball - 发射火球
• main.warps.gui - 使用gui编辑warp
• main.compact - 使用/compact命令

---

🪧 告示牌用法

以下是在 MainMC 插件中可用的告示牌类型及其格式：

• 余额 (balance):

  
  [balance]
  

• 购买 (buy):

  
  [buy]
  [amount]
  [id]
  [$price]
  

• 出售 (sell):

  
  [sell]
  [amount]
  [id]
  [$price]
  

• 免费 (free):

  
  [free]
  [id]
  

• 处理 (disposal):

  
  [disposal]
  

• Warp:

  
  [warp]
  [warpname]
  [$price]
  

• Kit:

  
  [kit]
  [kitname]
  [$price]
  

• 附魔 (enchant):

  
  [enchant]
  [enchantment:level]
  [$price]
  

• 游戏模式 (gamemode):

  
  [gamemode]
  [GM type]
  [$price]
  

• 治疗 (heal):

  
  [heal]
  [$price]
  

• 修复 (repair):

  
  [repair]
  [all/hand]
  [$price]
  

• 时间 (time):

  
  [time]
  [night/day]
  [$price]
  

• 天气 (weather):

  
  [weather]
  [sun/storm]
  [$price]
  

---

👨‍💻 Java 开发者 API

MainMC 插件为 Java 开发者提供了一系列 API，以便与其他插件进行交互。以下是一些可用的 API 示例：

经济 API

/*instance a new economy object passing to the constructor the player on which to perform the economy operations and the sum to add / destrat or set to the balance of the player*/
Economy economy = new Economy(Player, double);

public double getBalance() {}
//return Player balance

public void addMoney(){}
//add double to player balance

public void setMoney(){}
//set double as new player balance

public boolean detractable(){}
/*return true if the balance of the player minus the double is greater than 0*/

public void removeMoney(){}
//remove double from player balance

public void takeAll(){}
//remove double from all existing players

public void giveAll(){}
//add double from all existing players

public void setAll(){}
//set double as new balance to all existing players

public String toString() {}
//return balance as String format

public String getMoneyToString() {}
//return double as String format

public String getUser() {}
//return Player name

public static String topToString(int size) {}
//return balTop as list with size parameter as rows

public static String[] balTop(){}
//return array with all player names in order by BalTop

惩罚

Punishment punishment = new Punishment(String, String, String);
//instance punishment object using parameters as sanctioned player, punisher executor name, motivation of punishment

public void registerPunish(Punish punishtype, PunishType type, String time){}
/*save punishment in punishment file/s using parameters:
on PunishType paranter:
BAN, KICK, MUTE
on Punish parameter:
KickType (normal or all)
MuteType (perm or temp)
BanType (perm, temp or ip)
on String paramter:
insert time string format if you chosen temp type else insert null.
*/

public int getKickCount(){}
//return number of player sanctioned's kicks

public int getBanCount(){}
//return number of player sanctioned's bans

public int getMuteCount(){}
//return number of player sanctioned's mutes

位置工具

PluginLoc loc = new PluginLoc(double, double, double, World);
PluginLoc loc = new PluginLoc(Location);
//instance new PluginLoc object using a location or x,y,z and world

public String toString() {}
//return coordinates

public String toStringComplete() {}
//return coordinates with world yaw and pitch values

public String getWorld() {}
//return world location name

public World getServerWorld() {}
//return world location

public Location getLocation() {}
//return location

public Location getTop(){}
//return top location starting location parameter

public void strike(){}
//spawn lighting strike on location

public static Location getLocFromString(String str) {}
//return location by String that has format as toStringComplete() method

public static World findWorld(String string){}
//return World by name

时间工具

Time time = new Time(String);
//String parameter must be "1d,1m,1y,1h ecc.."

Time time = new Time(Date);

Time time = new Time(boolean, boolean, boolean, boolean, boolean, boolean);
//boolean parameters must be true if you want show the corripondent value: (boolean day, boolean month, boolean year, boolean hour, boolean minutes, boolean seconds)

Time time = new Time(String, String, String, String, String, String);
//use String parameters for create a date: (D,M,Y,h,m,s)

public static String getStringTimeFromSecond(int seconds) {}
//get time format as 10d 3h 60m 15s using seconds number

public boolean isPastOrPresent() {}
//return true if date attribute is past or is now

public boolean isDay() {}
//return true if