設定リファレンス
plugins/MapArtLandRental/config.yml の各セクションと設定項目について解説します。
完全な設定例
database:
type: sqlite
sqlite:
file: mapart.db
mysql:
host: localhost
port: 3306
database: mapart
username: mapart
password: ""
worker-threads: 2
maximum-pool-size: 4
economy:
enabled: true
provider: vault
rental:
initial-days: 7
extension-days: 7
maximum-total-days: 60
grace-period-hours: 24
expiration-check-seconds: 60
gui:
# Java EditionでNative Dialogを優先する
dialog: true
# Bedrock Edition UI。richはRich UI優先、defaultは通常Form優先
bedrock: rich
# 0は無制限
limits:
projects-per-owner: 0
leases-per-project: 0
active-leases-per-player: 0
world:
name: mapart_world
create-if-missing: true
void-generator: true
base-y: 64
base-material: SMOOTH_STONE
suppress-mob-spawn: true
fixed-weather: true
fixed-time: 6000
suppress-fire: true
suppress-explosion-damage: true
protection:
# 地図絵本体の周囲へ追加で貸し出す作業領域の幅
lease-buffer: 16
reset:
chunks-per-tick: 1
blocks-per-region-task: 4096
plot-types:
"128":
enabled: true
size: 128
initial-price: 5000
extension-price: 3000
origin-x: -64
origin-z: -64
stride-x: 256
stride-z: 0
"256":
enabled: true
size: 256
initial-price: 10000
extension-price: 6000
origin-x: -64
origin-z: 100032
stride-x: 512
stride-z: 0
"512":
enabled: true
size: 512
initial-price: 20000
extension-price: 12000
origin-x: -64
origin-z: 300480
stride-x: 1024
stride-z: 0
"1024":
enabled: true
size: 1024
initial-price: 40000
extension-price: 24000
origin-x: -64
origin-z: 700352
stride-x: 2048
stride-z: 0
"2048":
enabled: true
size: 2048
initial-price: 80000
extension-price: 48000
origin-x: -64
origin-z: 1501120
stride-x: 4096
stride-z: 0
各セクションの詳細解説
database(データベース設定)
データ永続化ストレージを指定します。 プラグインの起動時にスキーママイグレーションが自動実行されます。
| 項目 | 既定値 | 説明 |
|---|---|---|
type | sqlite | sqlite または mysql を指定します。 |
sqlite.file | mapart.db | SQLiteのデータベースファイル名です。 |
mysql.host | localhost | MySQLサーバーのホスト名です。 |
mysql.port | 3306 | MySQLサーバーのポート番号です。 |
mysql.database | mapart | データベース名です。 |
mysql.username | mapart | 接続ユーザー名です。 |
mysql.password | "" | 接続パスワードです。 |
mysql.worker-threads | 2 | データベース処理用の非同期ワーカースレッド数です。 |
mysql.maximum-pool-size | 4 | HikariCPの最大コネクションプール数です。 |
economy(経済連携設定)
| 項目 | 既定値 | 説明 |
|---|---|---|
enabled | true | レンタル時および延長時に通貨を引き落とすかどうかを指定します。false にするとすべて無料になります。 |
provider | vault | 経済プロバイダです。現在は vault のみをサポートします。 |
rental(レンタル期間設定)
| 項目 | 既定値 | 説明 |
|---|---|---|
initial-days | 7 | 初回レンタル時に付与される日数(日単位)です。 |
extension-days | 7 | 1回の延長操作で追加される日数(日単位)です。 |
maximum-total-days | 60 | 初回契約開始日からの最大レンタル通算日数です。これを超える延長は拒否されます。 |
grace-period-hours | 24 | レンタル期限が切れた後の猶予期間(時間単位)です。猶予期間が終了すると区画がリセットされます。 |
expiration-check-seconds | 60 | 期限切れ区画を検査するバックグラウンドタスクの間隔(秒単位)です。 |
gui(画面描画設定)
NegiLibを通じたUIの描画優先度を設定します。
| 項目 | 既定値 | 説明 |
|---|---|---|
dialog | true | Java EditionにおいてNative Dialogを優先します。サーバーやクライアントが非対応の場合はインベントリGUIへフォールバックします。false の場合は常にインベントリGUIを使用します。 |
bedrock | rich | Bedrock Edition(Geyser経由接続)でのUI表示形式です。rich はRich UIを優先し、対応しない場合に通常フォームへ切り替えます。default は常に通常フォームを使用します。 |
limits(利用上限設定)
プレイヤーやプロジェクトごとの上限値を設定します。0 を指定した項目は無制限となります。
| 項目 | 既定値 | 説明 |
|---|---|---|
projects-per-owner | 0 | 1人のプレイヤーがオーナーとして作成できるプロジェクトの最大数です。 |
leases-per-project | 0 | 1つのプロジェクトが同時に保持できる区画の最大数です。 |
active-leases-per-player | 0 | 1人のプレイヤーが同時に所有できるアクティブな区画の総数です。 |
world(ワールド設定)
マップアート制作専用ワールドの挙動を設定します。
| 項目 | 既定値 | 説明 |
|---|---|---|
name | mapart_world | 専用ワールド名です。 |
create-if-missing | true | 指定ワールドが存在しない場合に自動生成するかどうかを指定します。 |
void-generator | true | 完全な空気ブロックで満たされたボイドワールド生成器を適用します。 |
base-y | 64 | 床ブロックを配置する表面のY座標です。base-y - 1 には岩盤が配置されます。 |
base-material | SMOOTH_STONE | 表面に敷き詰めるブロック素材です。大文字小文字は不問で、minecraft: 名前空間も指定可能です。 |
suppress-mob-spawn | true | モンスターや動物の自然スポーンを阻止します。 |
fixed-weather | true | ワールド内の天候を晴れに固定します。 |
fixed-time | 6000 | ワールド内の時間を固定します(6000 は正午)。 |
suppress-fire | true | 火の延焼や自然消火を阻止します。 |
suppress-explosion-damage | true | 爆発による地形破壊を阻止します。 |
protection(保護設定)
| 項目 | 既定値 | 説明 |
|---|---|---|
lease-buffer | 16 | 地図範囲(Map Bounds)の外側に追加する作業用保護バッファの幅(ブロック数)です。全方向に等しく拡張されます。 |
reset(リセット負荷設定)
区画リセット時のTickあたり処理量を制限し、サーバー負荷のスパイクを防ぎます。
| 項目 | 既定値 | 説明 |
|---|---|---|
chunks-per-tick | 1 | 1Tickあたりに処理する最大チャンク数です。 |
blocks-per-region-task | 4096 | 1回のリージョンタスク内で走査および更新する最大ブロック数です。 |
plot-types(区画タイプ設定)
貸出可能な区画のサイズ、料金、配置座標を定義します。
| 項目 | 説明 |
|---|---|
enabled | このサイズを貸出可能にするかどうか(true / false)。 |
size | 地図絵本体のサイズ(128、256、512等)。 |
initial-price | 初回レンタル時の料金(経済有効時)。 |
extension-price | 1回あたりの延長料金(経済有効時)。 |
origin-x, origin-z | 最初の区画(インデックス0)の北西角座標。バニラ地図グリッド境界に合わせる必要があります。 |
stride-x, stride-z | 次の区画を並べるオフセット幅。区画サイズとバッファを足した値以上の間隔を空けます。 |