Skip to main content

設定リファレンス

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（データベース設定）​

データ永続化ストレージを指定します。 プラグインの起動時にスキーママイグレーションが自動実行されます。

項目既定値説明
typesqlitesqlite または mysql を指定します。
sqlite.filemapart.dbSQLiteのデータベースファイル名です。
mysql.hostlocalhostMySQLサーバーのホスト名です。
mysql.port3306MySQLサーバーのポート番号です。
mysql.databasemapartデータベース名です。
mysql.usernamemapart接続ユーザー名です。
mysql.password""接続パスワードです。
mysql.worker-threads2データベース処理用の非同期ワーカースレッド数です。
mysql.maximum-pool-size4HikariCPの最大コネクションプール数です。

economy（経済連携設定）​

項目既定値説明
enabledtrueレンタル時および延長時に通貨を引き落とすかどうかを指定します。false にするとすべて無料になります。
providervault経済プロバイダです。現在は vault のみをサポートします。

rental（レンタル期間設定）​

項目既定値説明
initial-days7初回レンタル時に付与される日数（日単位）です。
extension-days71回の延長操作で追加される日数（日単位）です。
maximum-total-days60初回契約開始日からの最大レンタル通算日数です。これを超える延長は拒否されます。
grace-period-hours24レンタル期限が切れた後の猶予期間（時間単位）です。猶予期間が終了すると区画がリセットされます。
expiration-check-seconds60期限切れ区画を検査するバックグラウンドタスクの間隔（秒単位）です。

gui（画面描画設定）​

NegiLibを通じたUIの描画優先度を設定します。

項目既定値説明
dialogtrueJava EditionにおいてNative Dialogを優先します。サーバーやクライアントが非対応の場合はインベントリGUIへフォールバックします。false の場合は常にインベントリGUIを使用します。
bedrockrichBedrock Edition（Geyser経由接続）でのUI表示形式です。rich はRich UIを優先し、対応しない場合に通常フォームへ切り替えます。default は常に通常フォームを使用します。

limits（利用上限設定）​

プレイヤーやプロジェクトごとの上限値を設定します。0 を指定した項目は無制限となります。

項目既定値説明
projects-per-owner01人のプレイヤーがオーナーとして作成できるプロジェクトの最大数です。
leases-per-project01つのプロジェクトが同時に保持できる区画の最大数です。
active-leases-per-player01人のプレイヤーが同時に所有できるアクティブな区画の総数です。

world（ワールド設定）​

マップアート制作専用ワールドの挙動を設定します。

項目既定値説明
namemapart_world専用ワールド名です。
create-if-missingtrue指定ワールドが存在しない場合に自動生成するかどうかを指定します。
void-generatortrue完全な空気ブロックで満たされたボイドワールド生成器を適用します。
base-y64床ブロックを配置する表面のY座標です。base-y - 1 には岩盤が配置されます。
base-materialSMOOTH_STONE表面に敷き詰めるブロック素材です。大文字小文字は不問で、minecraft: 名前空間も指定可能です。
suppress-mob-spawntrueモンスターや動物の自然スポーンを阻止します。
fixed-weathertrueワールド内の天候を晴れに固定します。
fixed-time6000ワールド内の時間を固定します（6000 は正午）。
suppress-firetrue火の延焼や自然消火を阻止します。
suppress-explosion-damagetrue爆発による地形破壊を阻止します。

protection（保護設定）​

項目既定値説明
lease-buffer16地図範囲（Map Bounds）の外側に追加する作業用保護バッファの幅（ブロック数）です。全方向に等しく拡張されます。

reset（リセット負荷設定）​

区画リセット時のTickあたり処理量を制限し、サーバー負荷のスパイクを防ぎます。

項目既定値説明
chunks-per-tick11Tickあたりに処理する最大チャンク数です。
blocks-per-region-task40961回のリージョンタスク内で走査および更新する最大ブロック数です。

plot-types（区画タイプ設定）​

貸出可能な区画のサイズ、料金、配置座標を定義します。

項目説明
enabledこのサイズを貸出可能にするかどうか（true / false）。
size地図絵本体のサイズ（128、256、512等）。
initial-price初回レンタル時の料金（経済有効時）。
extension-price1回あたりの延長料金（経済有効時）。
origin-x, origin-z最初の区画（インデックス0）の北西角座標。バニラ地図グリッド境界に合わせる必要があります。
stride-x, stride-z次の区画を並べるオフセット幅。区画サイズとバッファを足した値以上の間隔を空けます。