Bukkit Spigot Japan Wikiは、Hello Minecraftを応援しています。

超まいくらひろば2017バナー

 

 

プラグイン解説:MCBans

提供: Bukkit Spigot Japan Wiki
移動: 案内検索
プラグイン名 MCBans
製作者 Firestarthe他
配布場所 BukkitDev] / [MCBans
前提プラグイン なし
解説記事対応バージョン MCBans-4.3.5&Spigot-1.11
生成されるファイル MCBans>config.yml,sync.ini / languages>default.yml,dutch.yml,french.yml,german.yml,ja-jp.yml,norwegian.yml,portuguese.yml,spanish.yml,sv-se.yml
ライセンス GNU General Public License version 3 (GPLv3)
ソースコード github
関連サイト 公式サイト / フォーラム(en) / 非公式フォーラム記事
備考 非公式フォーラムに日本語の解説は有りますが、一部の情報が古い為こちらにも作っておきます。

MCBansについて

MCBansは、全世界のMCBans導入サーバからBAN情報を共有するプラグインです。
このプラグインによりある程度の荒らしやhacker等を遮断できます。

MCBansの導入方法

サーバー構築を参考にサーバーを構築しておいて下さい。

  1. 配布ページからプラグインをダウンロードして下さい。
  2. zipファイルであれば展開し、jarファイルを取り出します。
  3. jarファイルをサーバーのpluginsフォルダー内に配置します。
  4. サーバーを起動します。
  5. サーバーのコンソールに「pl」コマンドを実行させて一覧の中から、(プラグイン名)が緑色であればサーバーを停止します。
  6. pluginsフォルダー内に(プラグイン名)フォルダーが生成されたことを確認します。
  7. (プラグイン名)フォルダー内に(ファイル名)が生成されていれば導入完了です。

コマンド一覧

< >はコマンド入力に必須な引数を、[ ]はオプション(必須ではない)の引数を表します。
< - >: 前後の数字の範囲の中でいずれかを選択することを表しています。
< / >: 前後のどちらかを選択することを表しています。
true/false: 有効/無効にするかを選択するものです(true→有効,false→無効)。
string: 文字列、つまりテキスト、文章を書くことを表しています。
number: 数字を書くことを表しています。
(入力の際<>や[]は不要です) 筆記中

コマンド 説明
ローカルBANコマンド
/ban <プレイヤー名> [理由] プレイヤーをBANする
/rban <プレイヤー名> [理由] プレイヤーをBANし、そのプレイヤーのワールド変更をロジックプラグイン(HawkEye, LogBlock, CoreProtect)を使ってロールバックする
グローバルBANコマンド
/ban <プレイヤー名> g [理由] プレイヤーをグローバルBANする
/gban <プレイヤー名> [理由] プレイヤーをグローバルBANする
/rban <プレイヤー名> [理由] プレイヤーをグローバルBANし、そのプレイヤーのワールド変更をロジックプラグイン(HawkEye, LogBlock, CoreProtect)を使ってロールバックする
期限付きBANコマンド
/ban <プレイヤー名> t <数値> <m/h/d> [理由] プレイヤーを期限付きBANする
/tban <プレイヤー名> <数値> <m/h/d> [理由] プレイヤーを期限付きBANする
/rban <プレイヤー名> t <数値> <m/h/d> [理由] プレイヤーを期限付きANし、そのプレイヤーのワールド変更をロジックプラグイン(HawkEye, LogBlock, CoreProtect)を使ってロールバックする
コマンド例
ローカルBAN /ban yamagami2211 Griefing
グローバルBAN /ban yamagami2211 g Griefing
期限付きBAN /ban yamagami2211 15 m you are banned for 15 minutes
その他
/banip <ipアドレス> [理由] 指定したIPアドレスをBANする
/lookup <プレイヤー名> プレイヤーの履歴(ローカル/グローバルBAN)を検索して表示する
/banlookup <BanID> 指定したBanIDの詳細を表示する
/altlookup <プレイヤー名> 定したプレイヤーのサブアカウントを検索して表示する (プレミアムサーバのみ)
/kick <プレイヤー名> [理由] プレイヤーをKickする
/unban <プレイヤー名またはIPアドレス> プレイヤーまたはIPアドレスのBANを解除する
/mcbans コマンド一覧、説明を表示します

パーミッションノード一覧

一部未翻訳

パーミッションノード 説明
mcbans.ban.global グローバルBANする権限を与える
mcbans.ban.local ローカルBANする権限を与える
mcbans.ban.temp 一時的なBAN(期限付きBAN)する権限を与える
mcbans.ban.rollback rbanコマンドを使用できるようにする
mcbans.ban.ip IPBANする権限を与える
mcbans.unban 自分のサーバで行ったBANを解除する
mcbans.kick kickする権限を与える
mcbans.view.alts 複数のアカウントを持っているプレイヤーがログインしたときに、この権限を持つプレイヤーに通知する (プレミアムサーバ限定)
mcbans.view.bans 他のMCBans導入サーバでグローバルBANされているプレイヤーがログインしたときに、この権限を持つプレイヤーに通知する
mcbans.view.staff MCBansスタッフがログインしたときに、この権限をt持つプレイヤーに通知する(GlobalBAN等の権限を持つプレイヤーにはこれとは別に必ず通知される)
mcbans.view.previous 接続時のプレイヤーの前の名前を表示する
mcbans.announce View player is banned/kicked
mcbans.kick.exempt この権限を持っているプレイヤーに対してはkickコマンドを使えなくなります
mcbans.ban.exempt この権限を持っているプレイヤーに対してはbanコマンドを使えなくなります
mcbans.lookup.player lookupコマンドを使用可能にする
mcbans.lookup.ban banlookupコマンドを使用可能にする
mcbans.lookup.alt altlookupコマンドを使用可能にする(プレミアムサーバ限定)

config.ymlの初期設定

#########################################################
# MCBans Configuration File
# Plugin version 4.3.5 (Firestar, Syamn)
# - Main Site: http://mcbans.com
# - Support Desk: http://support.mcbans.com
# - Community: http://forums.mcbans.com
##

# prefix:
#   Prefix used for MCBans plugin messages to users on the server
#   DEFAULT: [MCBans]
prefix: "[MCBans]"

# apiKey:
#   Your servers apiKey can be found in your account dashboard http://my.mcbans.com/servers
apiKey: YOUR_API_KEY_HERE

# language:
#   Language you want to have displayed to the players
#   DEFAULT: default
language: default

# permission:
#   Choose permission controller: Vault, PermissionsEx, SuperPerms (default), OPs
#   DEFAULT: SuperPerms
permission: SuperPerms

# defaultLocal:
#   Default reason for users being locally banned from the server, if no reason is provided.
#   DEFAULT: "You have been banned!"
defaultLocal: "You have been banned!"

# defaultTemp:
#   Default reason for users being temporarily banned from the server, if no reason is provided.
#   DEFAULT: "You have been temporarily banned!"
defaultTemp: "You have been temporarily banned!"

# defaultKick:
#   Default reason for users being kicked from the server, if no reason is provided.
#   DEFAULT: "You have been kicked!"
defaultKick: "You have been kicked!"

#########################################################
# Loging and Debug
#   Debugging and MCBans message logging settings
##

# isDebug:
#   Enable additional debug messages throughout the plugin
#   DEFAULT: false
isDebug: false

# logEnable:
#   Enable logging MCBans actions and information to a file
#   DEFAULT: false
logEnable: false

# logFile:
#   Location and name of the file to log MCBans plugin data into
#   DEFAULT: plugins/MCBans/actions.log
logFile: "plugins/MCBans/actions.log"

#########################################################
# Alternate Account Limiting
#   Limits the how alternate accounts affect connectability to the server
##

# enableMaxAlts:
#   Activate limiting maximum number of alt accounts (true/false)
#   Limits the maximum number of alt accounts a user may have before
#   being denied access to the server.
#   DEFAULT: false
enableMaxAlts: false

# maxAlts:
#   Maximum number of alternate accounts allowed before denying user
#   DEFAULT: 2
maxAlts: 2

#########################################################
# Block logger plugin integration
#   Support LogBlock, HawkEye, CoreProtect plugin!
##

# affectedWorlds:
#   Worlds to issue log data or rollback
#   LogBlock and HawkEye Only! CoreProtect not supported this parameter ;(
#   DEFAULT: '*' ('*' to all worlds)
#   Multiple worlds: world,world_nether,3rdworld (no spaces)
affectedWorlds: '*'

# backDaysAgo:
#   days ago to roll back a player
#   DEFAULT: 20 (0 (<=0) to infinite)
backDaysAgo: 20

#########################################################
# MCBans syncing!
#   syncing for bans made into the banned-players.txt
##

# enableAutoSync:
#   Allow auto sync to banned-players.txt
#   DEFAULT: true
enableAutoSync: true

# autoSyncInterval:
#   sync every "autoSyncInterval" and grab/delete bans in minutes
#   DEFAULT: 5 (5 Minutes)
autoSyncInterval: 5

#########################################################
# Miscellaneous Settings
#   Settings that don't have a part of any other sections
##

# onJoinMCBansMessage:
#   Display "Server protected by MCBans.com" advertisement notice to users upon connection.
#   DEFAULT: false, RECOMMENDED: true
onJoinMCBansMessage: false

# sendDetailPrevBansOnJoin:
#   Show detail previous bans information (banned server, reason, issued by) on player join.
#   (Require "mcbans.view.bans" permission. "mcbans.hideview" is exempt permission.)
#   DEFAULT: true
sendDetailPrevBansOnJoin: true

# minRep:
#   Minimum reputation a user may have before being disallowed access to the server.
#   DEFAULT: 3 (-1 to disable)
minRep: 3

# callBackInterval:
#   Time (in minutes) between callbacks to the MCBans Master Server
#   (Excluding the API connections on userConnect)
#   DEFAULT: 15 (15 Minutes)
callBackInterval: 15

# timeout:
#   Timeout (in seconds) value of connecting mcbans API server while player joining the server.
#   DEFAULT: 10 (10 Seconds)
timeout: 10

# failsafe:
#   If set to true, disallow access to the server when can't auth players,
#   unavailable mcbans api servers (timeout), internal plugin error etc.
#   DEFAULT: false
failsafe: false

#########################################################
# DO NOT TOUCH
#   Do not touch this option! It is a check if you are running the recent configuration version
##
ConfigVersion: 2

config.ymlの設定変更

  • YAML形式の記述方法についてはYAMLファイルを参照して下さい。

< - >: 前後の数字の範囲の中でいずれかを選択することを表しています。
< / >: 前後のどちらかを選択することを表しています。
<true/false>: その項目の機能を有効/無効にするかを選択するものです(true→有効,false→無効)。
string: 文字列、つまりテキスト、文章を書くことを表しています。
number: 数字を書くことを表しています。
(入力の際<>は不要です) 筆記中

項目 デフォルト 説明
項目1 デフォルト1 説明1
項目2 デフォルト2 説明2

システム

プレイヤーがサーバにログインしようとしたときに、MCBansプラグインはそのプレイヤーがサーバに接続出来るかどうかを、MCBansサーバに問い合わせます。
接続できる場合は、そのプレイヤーが別のサーバでBANされていたり、何か表示すべき情報があるとき、サーバのコンソールやオンライン中のスタッフへメッセージを送信します。
出来ない場合は、その理由(BANメッセージや、評判値が0になったなど)をプレイヤーとコンソールに送信し、サーバへの接続を拒否します。

セットアップ方法

次の手順に従ってください。

  • MCBans.comのアカウント作成から貴方のユーザーアカウントを作成します。
  • 次にそのアカウントとMinecraftを紐付けるためにMCBans認証用ゲームサーバ(server.mcbans.com)に接続し、認証コードをコマンドで入力します。
  • プラグインをダウンロードし、貴方のゲームサーバのpluginsディレクトリに置き、サーバを起動します。
  • 自分のサーバリストページにアクセスして、あなたのサーバAPIキーをコピーします。
  • plugins/MCBAns/config.ymlを開き、apikey設定値にコピーしたAPIキーを貼り付け、必要に応じて他の設定を編集し、サーバを再起動します。

グローバルBANルール・ガイドライン

Valid Global Ban Reasons Valid reasons for global bans:

  • Griefing (Theft is included here. Please be sure to have screenshot proof). Please note that this can include edits and additions (not only block destructions), if done in a malicious manner to another player's build. For guidelines regarding the minimum number of block edits required in order for a griefing ban to be valid for the global list, see blue note #1 at the bottom of this section.
  • Causing server downtime by DoS or any other malicious method (Please note that proof must be very thorough for bans of this type).
  • Spambot ("Spamming/Spam/Spamming Chat" are not allowed, it must actually be automated)
  • Client-side modifications (Please be specific with your reason - "Hacking" is not enough information - See note #2 at the bottom of this section).
  • X-Ray related modifications (This includes x-ray texture packs)
  • Racism - follow the following process:
    • 1) Is it aimed at a player in a way which is clearly abusive?
      • Yes, go to 2
      • No, LOCAL ONLY
    • 2) Is it in public chat or a private message?
      • Public, CAN GLOBAL
      • No, LOCAL ONLY
    • 3) Is there a complaint from the player in question?
      • Yes, CAN GLOBAL
      • No, LOCAL ONLY
  • Homophobia - follow the following process:
    • 1) Is it aimed at a player in a way which is clearly abusive?
      • Yes, go to 2
      • No, LOCAL ONLY
    • 2) Is it in public chat or a private message?
      • Public, CAN GLOBAL
      • Private, go to 3
    • 3) Is there a complaint from the player in question?
      • Yes, CAN GLOBAL
      • No, LOCAL ONLY
  • Posting direct links to pornographic material or "shock" websites
  • Nazi symbols. Please note: In order to be valid for a global ban, such symbols must be placed with the intent to harass or vandalize, not by mistake or for a legitimate historical purpose. In cases where the intent is ambiguous, MCBans staff will issue a “soft local,” meaning that the ban is localized without penalty to the server.
  • Honeypots (Server must comply with Honeypot guidelines)

Note #1: For griefing bans on creative servers, the player must have broken at least 5 blocks in a malicious manner in order for the ban to be valid for global. On survival servers, a ban involving more than 3 malicious block breaks is valid for global. Global bans on survival servers involving fewer than 3 block breaks may be localized in disputes (without penalty to the server) at the discretion of MCBans Dispute Team Staff.

Note #2: Concerning client side modifications: simply using a modified/hacked client is not valid for a global ban. Please be sure to get proof of the player using the malicious hacks on your server. Please specify in your reason which type of hacking it is. Example: Flymod



Invalid Global Ban Reasons
These ban reasons are NOT valid for the global ban list, and will be reported and localized. Invalid reasons for global bans are, but not limited to:

  • Harassment of server players or staff
  • Spamming
  • Too many alternate accounts
  • Ban reasons containing any foul language or name-calling
  • Griefing teams
  • Impersonation of MCBans staff
  • Impersonation of Planet Minecraft staff, or similar
  • Advertising or threats
  • Any builds containing male or female genitalia

Operating your server in Online Mode
It is important that your server remains in online mode while running the MCBans plugin for various reasons. These reasons include the inability to verify players against the Minecraft servers. This can have drastic undesired effects.

The MCBans Administration NEVER allow servers to run in offline mode. 
Servers found to be running in offline mode will be immediately removed from the system without notice by MCBans Staff or prior warning to the server's administration team.
 This means that your server will be locked out from using the MCBans service indefinitely.

Proof Policy
When making a global ban, please be sure to retain screenshot or log proof for the ban. If a dispute is escalated to MCBans staff, we can and will ask the server for proof. It is very important to provide proof as promptly as possible as to not slow down the dispute process and to prevent your server from losing reputation. Proof must be shown in disputes even if the player admits to doing it.

Proof should contain screenshots from a block-logging program such as logblock, and should never be based on speculation alone.

Hamachi Server Policy
Effective January 25th, 2012, Hamachi servers are not allowed to be created on the MCBans system. Any server found to be a Hamachi server will be removed and the offending server owner will be cautioned by MCBans staff. Repeat offenses such as recreating the server in the system may result in the inability to access the MCBans service or servers. Home-hosted servers ARE allowed, however must not be running Hamachi or by any other related VPN service.

Improper Bans Policy
As stated as an invalid global ban above, improper ban reasons will be investigated by MCBans staff and then localized. The offending server WILL lose reputation. Any form of foul language, harassment, or name-calling in a ban reason will result in the ban being reverted to local. For example: "needs to get a life" or "because I said so" will be localized on sight. Globally banning players that have never connected to your server will result in the ban being changed to local and the banning server being penalized or removed from the system. Ban retaliation such as "They banned us from their server!" is not a valid excuse.

NoCheat Information
NoCheat or an equivalent plugin is a good way to monitor hacking on your server. However, we expect servers to use caution when banning with the direct aid of NoCheat. Please read below before issuing a ban with the aid of NoCheat to avoid issuing an invalid global ban. Although it is rare, server lag can and will obscure or deform NoCheat's abilities to "pick up" cheaters. It is rare that we will accept bans for "extra packets" due to false triggers.

Acceptable VL Level for Global Ban: 600+

Additional Important Information
Failure to abide by the above rules may result in your server being disabled from using the MCBans service, and your IP address being nullified. When a server is disabled, the system will automatically mark all bans on the server as void. A backup of your bans is accessible at all times in your banned-players.txt on your server. When issuing bans, please only use the English language as our staff team is only available in English. Any bans in a different language other than English will be localized unless MCBans staff decide to take the time to join the server under their own discretion.

Please also note that social engineering is NOT a type of hacking. If a player claims to be from Planet Minecraft or related service, they are most likely wanting easier griefing or planning malicious intent. It is recommended that you locally ban these types of users immediately.

異議申し立て

全てのグローバルBANはMCBansチームに英語でのみ異議申し立てを行うことが出来ます。
異議申し立てを行いMCBansスタッフがそのBANを無効と判断した場合、そのBANはローカルBANに戻され、プレイヤーの評判値が回復します。
サーバがグローバルBANに対しての証拠を提出しない場合や提出した証拠が無効、偽造されたものである場合、またはグローバルBANの理由そのものが無効である場合のみ、ローカルBANに差し替えは行われます。
正当な証拠が提出されたグローバルBANについてはMCBansチームはそのBANを変更しません。

MCBansチームへの異議申し立ては、実際にグローバルBANが行われた日より起算して60日以内に行う必要があります(60日ルール)。
これは、それぞれのサーバが60日を超える長期に渡って証拠を保持していることに期待できないからです。

追加情報

MCBansスタッフの成りすましを行うユーザーを見つけた場合は、MCBansのIRCチャンネルまたはMCBansフォーラム等の方法で正規のMCBansスタッフへ連絡してください。
これらの行為はMCBansへの迷惑行為として、即座に全てのMCBansサーバへのアクセスが禁止されます。
正規のMCBansスタッフがサーバにログインした際に、プレイヤーとコンソールにスタッフメンバーである旨が表示されます。
MCBansスタッフの一覧はこちらで確認できます。

リンク