BTC Sky
概要
BTC Sky は、BTC ビルドの TypeWriter のスカイブロックエンジンです。各プレイヤープロファイルが、1 つの島を所有します。島は、1 つ以上のディメンション(オーバーワールド、ネザー、エンド、または設計した任意のカスタムワールド)でできており、それぞれがテンプレートワールドから複製され、Dimension Template で設定されます。各ディメンションには、独自のサイズ、アップグレード、制限、ジェネレーター、シーズン、イベント、戦闘の設定があります。
プレイヤーは、チャンク、アップグレード、ジェネレーターのティアを購入し、新しい技術をリサーチし、コレクションを埋め、契約を請け負い、他の島を訪問したり戦ったりして、島を成長させます。すべては Web パネルで設定します。1 つの BTC Sky Main Configuration がグローバルなルールを保持し、ディメンションごとの 1 つのテンプレートがゲームプレイを保持し、BTC Sky Menu がコントロールパネルを構築します。
BTC Sky は非公開の拡張機能です。BTC Core(Advanced Slime Paper を備えた Paper または Folia)上で動作し、ここでは参考情報として文書化されています。他の BTC 拡張機能がこれに依存しています。Machine は、配置、制限、リサーチのティアにその島を使い、FakeBlock は、そのディメンションにスキマティックを固定できます。
機能
- プロファイルに紐づく島 — プロファイルごとに 1 つの島。ディメンションテンプレートから作成され、協力プロファイルのオーナー同士で共有されます。
- 複数のディメンション — 島ごとに、好きなだけディメンションを解放して設計でき、それぞれに独自の進行があります。
- チャンクの拡張 — 1 チャンクから始めて、さらに購入できます。コスト曲線、カスタムチャンク、パーティクルとワールドボーダーによるライブプレビューを設定できます。
- ロールと設定 — 訪問者、メンバー、モデレーター、管理者、リーダーのロール、ディメンションごとの権限、島のフラグ(PvP、飛行、モブのスポーン、爆発、訪問者のルール)。
- リサーチツリー — ブランチとノードを、フラグメントの投入、燃料のセット、調理時間の待機によって解放します。
- シーズンとイベント — ディメンションごとのシーズンと、組み合わせ可能なイベント(流星群、嵐、モブウェーブ、ボス、宝の雨)。
- ジェネレーターとアップグレード — ティア制の丸石ジェネレーターと、データ駆動のアップグレードカタログ。
- 制限 — ブロック、エンティティ、マシン、ペットの制限に加え、ディメンションごとのモブの個体数バジェット。
- 島のバンクと契約 — サーバー経済を兼ねるバンクと、Contracts Table でのプレイヤー間の契約。
- コレクション、ランキング、戦争 — レベル報酬付きのグローバルコレクション、レベルのリーダーボード、島同士の戦争キュー。
- TypeWriter 向けのフック — 38 個のファクト、33 個のイベント、グループ、1 つの目標、そして、島を中心にクエストを組むための多くのアクション。
インストール
- BTC Core を含む BTC ビルドの TypeWriter をインストールします。島のワールドは Advanced Slime Paper で作成されるため、サーバーがそれを提供している必要があります。
- BTC Sky が必須と宣言している拡張機能をインストールします。Region、Entity、RoadNetwork、BTCMobs です。実際には、Profiles 拡張機能(各島はプロファイル ID をキーとします)と、GUI 拡張機能(メニュー)も必要です。
- 任意の拡張機能: MySql(サーバー間の共有ストレージ)、UiCore(高度なメニューとバナー)、社交的な連携のための Party、Friend、Guild、通貨のための NumericalStorage、カスタムブロックのための CraftEngine、カスタムバイオームのための CustomBiome、クライアント側のボーダーとホログラムのための PacketEvents。プレースホルダーには MiniPlaceholders が必要です。
- BTC Sky の JAR を
plugins/Typewriter/extensions/に置き、サーバーを再起動します。 - ディメンションごとに 1 つのテンプレートワールドを作成し、
templateWorldNameに付ける名前で、サーバーのslime_worldsフォルダに置きます。
仕組み
インスタンス
インスタンスは、1 つの島の 1 つのディメンション内に配置された、ゲームオブジェクトのコピーです。BTC Sky には 2 種類のインスタンスエントリがあります。BTC Sky Instance は、指定したディメンション(targetDimension)内の、ディメンションのスポーン地点からのオフセット(spawnOffset)に、エンティティ(NPC または BetterModel のモデル)をスポーンさせ、経路探索用の Road Network を任意で指定できます。Island NPC Instance は NPC 版で、位置が島のディメンションごとに保存されるため、島ごとに独自のコピーがあり、オーナーは Move Island NPC アクションで動かせます。
ディメンションテンプレート
Dimension Template は、1 つのディメンションの設計図です。メイン設定の dimensionTemplates リストに追加します。次の内容を定義します。
| グループ | フィールド | 制御する内容 |
|---|---|---|
| アイデンティティ | dimensionId, displayName, priority, description, icon, menuSlots | ディメンションの名前と、メニューでの表示方法。 |
| ワールド | templateWorldName, defaultBiome, allowedBiomes, spawn | 島ごとに複製されるワールド、プレイヤーが選べるバイオームのグループ、スポーンの角。 |
| アクセス | unlock | デフォルトで解放されているか、プライマリのディメンションか、コスト、必要な島のレベル、権限、解放時に発動するアクション。 |
| サイズ | expansion | 一辺あたりのチャンク数での初期サイズと最大サイズ、コスト曲線、カスタムチャンク、プレビュー用の素材。 |
| 制限 | limits | ブロック、エンティティ、マシン、ペットの制限と、ワープの制限。 |
| 個体数 | spawner, mobLevelAtCenter, mobLevelAtEdge | モブのスポーン率、距離、上限と、中心から端までのモブのレベル。 |
| 経済 | blockValues, generator, multipliers | 各ブロックの島レベルの価値、ジェネレーターのティア、作物、ドロップ、スポナー、XP の倍率。 |
| 人 | rolePermissions, overrideGlobalFlags, enabledFlags | このディメンションで、各ロールができること。 |
| 時間 | seasons, events | 季節のテーマと、ランダムな島のイベント。 |
| 進行 | upgrades | このディメンションのアップグレードカタログ。 |
| 戦闘とクリスタル | combat, crystal, crystalOffset, crystalMovable | 戦争の設定と、ディメンションの安定化クリスタル。 |
安定化クリスタルには、3 つの状態(crystal)があります。ACTIVE はディメンションのコントロールルーム(とそのマシンダッシュボード)を開き、DECORATIVE はインタラクションを拒否する飾りで、ABSENT は設置を禁止します。
島
島はプロファイルに属し、その ID はプロファイル ID です。島は、ディメンション、設定、メンバー、アップグレード、バンクの残高、統計、リサーチの進行、コレクション、ワープ、ホログラム、評価、BAN を保持します。島は Player Sky Data Artifact に保存され、メイン設定の playerSkyDataArtifact フィールドで参照します。
島は、Create Island アクションで、テンプレートから作成されます。デフォルトでは、何も自動的には作成しません。プロファイルの作成直後に、プライマリの島を作成して入場させるには、autoProvisionIslandOnProfileCreation を設定します。オフのままにしておけば、チュートリアルやメニューで、後から島を解放できます。
島のレベルは、各ディメンションの blockValues から、スキャナーによって計算されます。積み重ねられたブロックはレベルに数えられますが、占有するスペースは 1 ブロック分です。
メンバー、ロール、協力プレイ
| ロール | 意味 |
|---|---|
VISITOR | メンバーではない全員。 |
MEMBER | 基本的なアクセス権を持つ、オーナーのフレンド。 |
MODERATOR | 招待とキックができます。 |
ADMIN | 解散を除く、すべての管理ができます。 |
LEADER | オーナー。 |
オーナーは、フレンド(members)にロールを割り当てます。上位のロールは権限レベルであり、フレンドを共同オーナーにするものではなく、進行を共有するものでもありません。各ロールができること(BUILD、BREAK、CHEST_ACCESS、INVITE、KICK、BAN、SET_WARP、SET_HOME、SET_BIOME、MANAGE_FLAGS、MANAGE_UPGRADES、TRANSFER、DISBAND など)は、テンプレートの rolePermissions で、ディメンションごとに設定します。
**協力プレイ(Coop)**は異なります。協力の島には複数のオーナーがおり、島の進行(リサーチ、コレクション、レベル)を共有します。協力プレイには、Profiles 拡張機能の Coop プロファイルが必要です。オーナーまたは島の管理者が、Invite Coop Partner アクションでプレイヤーを招待します。招待は 60 秒で失効し、Accept Invite で承諾、Decline Invite で辞退します。Coop Countable Objective は、協力の島では目標値が 2 倍になります。
島の設定(フラグ)は、島ごとに切り替えます。IS_OPEN、ALLOW_FLY、IS_PVP_ENABLED、IS_MOB_SPAWNING_ENABLED、IS_EXPLOSIONS_ENABLED、IS_FIRE_SPREAD_ENABLED、VISITOR_ITEM_PICKUP、VISITOR_ITEM_DROP、VISITOR_DOOR_USE、VISITOR_CONTAINER_ACCESS、VISITOR_ANIMAL_INTERACT、BORDER_VISIBLE、WORLD_BORDER です。
アップグレード、ジェネレーター、制限
各ディメンションは、自身の upgrades を列挙します。アップグレードには、cost、effectValue、そして購入時の任意のアクションを持つレベルがあります。effectType が、その動作を決めます。作物の成長、モブのドロップ、スポナーの速度の倍率、ポーションと島のエフェクト、ブロックとエンティティの制限の増加、チームの人数、ワープの制限、ジェネレーターのティア、島での飛行、イベントの頻度と戦利品、イベントの解放、またはアクションによるカスタムエフェクトです。upgrades に手を加えなければ、組み込みのデフォルトのカタログが使われます。
丸石のジェネレーターにはティア(generator.tiers)があり、それぞれ cost と、rates(バニラのブロックまたは CraftEngine のブロック ID と、パーセンテージ)のリストを持ちます。tiers を空にすると、オーバーワールド、ネザー、エンドの組み込みのデフォルトが使われます。
制限はテンプレートからのみ決まります。列挙されていないブロックやエンティティのタイプは、無制限です。各制限には基本値があり、アップグレード可能にもできます(upgradeCost、upgradeIncrease)。マシンとペットの制限は、それらの拡張機能がインストールされている場合に適用されます。spawner ブロックは、モブの個体数バジェット(maxNearbyMobs、maxPerChunk、テンプレートごとの上限)を追加し、1 つの農場が他のすべてのスポーンを止めてしまうことを防ぎます。UiCore がインストールされている場合、上限によってスポーンが拒否されると、プレイヤーにバナーが表示されます。
リサーチ
リサーチツリーは、個別のエントリではなく、メイン設定の research セクションで定義します。
- ブランチ(
research.branches)は、レベル曲線を持つカテゴリです。レベルごとに必要な XP、付与されるポイント、レベルアップ時に実行されるアクションを持ちます。 - ノード(
research.nodes)はブランチに属し、x/yの位置に置かれ、parents、powerCost、requiredLevel、criteria、fuels、output、successChance、繰り返しの設定、報酬を列挙します。 - フラグメント(
research.fragments)は、パワーを与えるアイテムです。
ノードは、段階を踏んでリサーチされます。プレイヤーはノードにフラグメントを入れてパワーを満たし、燃料アイテムを 1 つセットすると、ノードは燃料の持続時間だけ調理され、その後プレイヤーが結果を受け取ります。成功すると rewards(それぞれに独自の確率があります)が実行され、recipes に列挙されたレシピが解放されます。失敗すると failRewards が実行されます。リサーチは島に属するため、全オーナーで共有され、レシピは参加時に各プレイヤーに返されます。他の拡張機能は、解放されたノードを読み取ります。たとえば、Machine のティアは、リサーチノードを指定します。
Research Branch と Research Node の manifest エントリは存在しますが、リサーチの実行時はメイン設定を読み取るため、ツリーはそこで定義してください。クエストに接続するには、Research Grant Points、Research Grant XP、Unlock Research、Open Research Menu の各アクションを使います。
シーズン
シーズンは、seasons でディメンションごとに設定し、デフォルトではオフです(enabled)。2 つのタイミングモードがあります。
FIXED_DURATION— 各シーズンは、実時間でfixedDurationHours(デフォルトは 168、1 週間)続きます。CALENDAR_LINKED— TinyEssentials のカレンダー(calendar、startMonth)の 1 年が、シーズン間で均等に分割されます。
各シーズンの定義(definitions。デフォルトは春、夏、秋、冬)は、バイオームの上書き、天候パターン(CLEAR、RAIN、THUNDER、SNOW)の設定、作物の成長、モブのスポーン、モブのドロップ、XP の倍率、パーティクルの表示、開始時と終了時のアクションの発火ができます。Season Change イベントが、変化のたびに通知します。
イベント
島のイベントは、組み合わせ可能な枠組みです。Island Event は、いつ実行できるか(chancePerCheck、weight、cooldownMinutes、minimumPlayers、conditions、requiredUpgradeId、許可および禁止するディメンション)を記述し、再生するメカニクス(mechanics)を列挙します。ディメンションが使えるイベントは、テンプレートの events.events に追加します。minIntervalMinutes と maxIntervalMinutes が、チェックの間隔を決めます。
メカニクスは、組み合わせて使う個別のエントリです。Meteor Shower、Treasure Rain、Mob Wave、Storm、Eclipse、Boss、Event Ambience(パーティクルとサウンド)、Event Flag、Event Trigger(アクション)、Temporary Multiplier(XP またはドロップ)、Temporary Client Block、Coop Buff、BetterModel Impact です。これらは、下のエントリの一覧に載っています。
経済、契約、コレクション
島のバンクは、島のお金を保持します。経済プラグインのないサーバーでは、バンクがサーバー経済として公開されるため、プレイヤーのお金は、島のお金になります。入金と出金は、Island Bank Deposit と Island Bank Withdraw アクションで行います。テンプレート内のコストは、通貨の参照(currency)を使い、NumericalStorage のものなどの、通貨エントリを指します。
契約は、Contracts Table で結ばれる、プレイヤー間の合意です。デフォルト(contractsRequireWorkstation)では、メニューはテーブルのブロック(contractsTableBlock。デフォルトは製図台)からしか開きません。報酬には、contracts.rewardTaxPercent による税がかかります。
コレクションは、島が収穫、討伐、釣りをしたものを、アイテムごとに記録し、レベルのしきい値を持ちます(collections.categories)。各レベルは、アクションを 1 回実行できます(onReach)。プレイヤーは、Unlock Collection アクションで、コレクションを解放したりロックしたりすることもできます。
戦争
テンプレートで combat.enabled が設定されている場合、そのディメンションの島は、戦争に参加できます。島は、(コントロールパネルから)攻撃側または防衛側として戦争キューに入り、反対の役割でキューに入っている島とマッチングされます。島は combatWar.minIslandLevel に到達している必要があり、combatWar.warCooldownMinutes が 2 つの戦争の間隔を空けます。戦闘そのものはテンプレートが設定します。コアの体力と再生(coreHealth、coreRegeneration)、durationMinutes、attackCooldownHours、スポーン地点、開始、勝利、敗北時のアクションです。勝者は、敗者のバンクの一部を略奪できます(combatWar.pillagePercent)。勝ち、負け、引き分けは、島の統計に記録されます。
Archipel
Archipel des Métiers は、共有された読み取り専用のワールド(readOnlyWorlds に列挙)で、島が復興する 9 つの小島からなります。アクセス、橋、ティアは島に保存され、archipel_* のファクトとアクションとして公開されます。
はじめに
1 つのディメンションを持つ最初の島を作成し、プレイヤーがコントロールパネルを開けるようにします。
- TypeWriter の Web パネルで static ページを開き、Player Sky Data Artifact を追加します。
- Dimension Template を追加します。
dimensionIdをoverworld、templateWorldNameを、テンプレートワールドの名前に設定し、unlock.isPrimaryはオンのままにします。expansion(initialSizeChunks、maxSizeChunks、baseCost)を調整します。 - BTC Sky Main Configuration を追加します。
dimensionTemplatesにテンプレートを、playerSkyDataArtifactにアーティファクトを設定します。 - ID が
control_panelの BTC Sky Menu を追加し(Contracts Table はこのエントリを開きます)、そのlayoutPoolとviewsを作成して、動的リストのテンプレートを持つ BTC Sky Menu Configuration を追加します。 templateにテンプレートを設定した Create Island アクションを追加し、ボタン、コマンド、またはチュートリアルのステップに接続します。- パブリッシュします。プロファイルを作成し、アクションをトリガーすると、テンプレートワールドとともに島が現れます。
- スタッフのアカウントで
/typewriter island admin search <name>を使って、管理者の流れをテストします。
BTC Sky は、コマンドを TypeWriter のコマンドの下に登録します。トップレベルの /island は拡張機能では定義されていません。BTC Sky Menu をトリガーするコマンドエントリで作成してください(コマンドを参照)。
コマンド
島のコマンドは @TypewriterCommand として登録されるため、/typewriter(エイリアス /tw)の下にあります。メニューはプレイヤーに代わってそれらを実行するため、ほとんどは内部用です。
島のコマンド
| コマンド | 説明 |
|---|---|
/typewriter island | コントロールパネルを開きます。 |
/typewriter island visit <islandId> | 公開されている島に、BAN されていない限りテレポートします。 |
/typewriter island invite [player] | 招待ダイアログを開くか、オンラインのプレイヤーを協力パートナーとして招待します。 |
/typewriter island dimension tp <dimId> | 自分の島のディメンションにテレポートします。 |
/typewriter island dimension buy <dimId> | 自分の島のディメンションを解放します。 |
コントロールパネルは、次の内部コマンドも実行します。タブとディメンションのナビゲーション(dim_select、list_scroll、cp、close)、拡張(expansion_map、expansion_nav、buy_chunk)、レベル(recalculate_level、recalc_level)、ワープ(warps、warp、warp_create、warp_delete、warp_edit、warp_set_icon、warp_toggle_public)、メンバー(members、member_manage、member_promote、member_demote、member_kick)、モデレーション(visitor_kick、visitor_ban、unban)、ボーダー(border …)、ホログラム(holograms、create_hologram、edit_hologram)、契約(contracts_browse、contract_apply、contracts_create、contract_accept、contract_reject、contract_cancel と関連するもの)、アップグレード(upgrade、upgrade_confirm、upgrade_generator)、リサーチ(research_input、research_feed、research_fuel、research_claim)、戦争(declare_war、combat_queue、combat_history、attack)、評価(rate)、バイオーム(biomes、set_biome、set_chunk_biome)、設定(toggle_setting、fly_toggle、fly_scope)、ランキング(ranking_sort、ranking_dim)です。手で入力するためのものではありません。
協力プレイの招待のチャットボタンは、/island coop accept と /island coop deny を実行します。これらのサブコマンドは拡張機能によって登録されないため、Accept Invite と Decline Invite を、独自のコマンドに接続してください。
メイン設定の commandAliases(デフォルトは island、is、islands)は、メニューシステムに、どのコマンドの単語を島のツリーに振り分けるかを伝えるだけです。新しいコマンドを登録するものではありません。
管理者用コマンド
admin ブランチ全体に、btcsky.admin(またはオペレーター権限)が必要です。
| コマンド | 説明 |
|---|---|
/typewriter island admin search <query> | ID、オーナー、メンバー名で島を検索します。 |
/typewriter island admin create <player> <template> | オンラインのプレイヤーのために、テンプレート(エントリ ID またはディメンション ID)から島を作成します。 |
/typewriter island admin delete <profileId> | 島を削除します。 |
/typewriter island admin tp <player or id> | 島にテレポートします。 |
/typewriter island admin setlevel <profileId> <level> | 島のレベルを設定します。 |
/typewriter island admin eco <islandId> get, set <amount>, add <amount> | 島のバンクを、読み取る、設定する、加算します。 |
/typewriter island admin collection <islandId> <collectionId> <level> | コレクションのレベルを設定します。 |
/typewriter island admin upgrade <upgradeId> <level> | 今いる島の、選択したディメンションのアップグレードレベルを設定します。 |
/typewriter island admin unlock dimension <islandId> <dimId> | 島のディメンションを解放します。 |
/typewriter island admin event <eventId> | 自分の島で、島のイベントを今すぐ開始します。 |
/typewriter island admin limit show <profileId> | エンティティの制限を、実際の数と並べて表示します。 |
/typewriter island admin limit budget <profileId> <dimensionId> <value> | ディメンションのモブのバジェットを設定します(unlimited または -1 で解除)。 |
/typewriter island admin limit species <profileId> <dimensionId> <entityType> <value> | 1 つのエンティティタイプの上限を設定します。 |
/typewriter archipel, acces, passerelle <islet>, palier <islet>, ouvrir | Archipel のアクセス、橋、ティアを確認し、付与します(権限 btcsky.admin.archipel)。 |
権限
| 権限 | 許可される内容 |
|---|---|
btcsky.admin | /typewriter island admin ブランチ全体。 |
btcsky.admin.search, .create, .delete, .tp, .setlevel, .eco, .collection, .upgrade, .dimension, .event, .limit | 管理者用の各サブコマンド。より細かい権限による代替手段です。親のブランチには、引き続き btcsky.admin またはオペレーター権限が必要です。 |
btcsky.admin.archipel | /typewriter archipel のコマンド。 |
btcsky.admin.bypass | プレイヤーが管理者のバイパスフラグも持っている場合に、島の保護とワープの制限を回避します。 |
btcsky.admin.dimensions | 解放されていないディメンションに入ります。 |
btcsky.warp.unlimited | ワープの制限を無視します。 |
btcsky.contracts.bypass | Contracts Table を通さずに契約を開きます(設定可能: contractsBypassPermission)。 |
contracts.permissionLimits の権限 | 開ける契約の数を増やします。 |
BTC Sky Permission Definitions エントリと、メイン設定の permissions および commands セクションには、さらに多くのノード(btcsky.island.*、btcsky.vip.*、btcsky.command.*)が列挙されています。これらはドキュメントであり、現在のコードはそれらをチェックしません。
プレースホルダー
TypeWriter を通じて提供される、btcsky エクスパンションの MiniPlaceholders のタグです。島のないプレイヤーには、has_island 以外のすべてのタグで 0 が返されます。ディメンションが必要な場所では、current はプレイヤーが立っているディメンションを意味し、引数を省略した場合も、そのディメンションがデフォルトです。
島
| プレースホルダー | 返す値 |
|---|---|
<btcsky_has_island> | true または false。 |
<btcsky_context_state> | プロファイルと島の紐づけの状態(ない場合は NO_PROFILE)。 |
<btcsky_island_id> | 島(プロファイル)の ID。 |
<btcsky_island_owner>, <btcsky_owner_name> | オーナー名。 |
<btcsky_island_role> | 島でのプレイヤーのロール。 |
<btcsky_island_level>, <btcsky_level> | 島のレベル。 |
<btcsky_island_balance>, <btcsky_bank_balance> | バンクの残高。 |
<btcsky_island_members_count>, <btcsky_member_count> | メンバー数。 |
<btcsky_island_members_online> | オンラインのメンバー。 |
<btcsky_member_max> | アップグレードを含む、チームの人数の上限。 |
<btcsky_team_members_list> | カンマ区切りのメンバー名。 |
<btcsky_is_coop_island> | 協力の島の場合は true。 |
<btcsky_island_creation_date> | 作成日(yyyy-MM-dd HH:mm:ss)。 |
<btcsky_island_worth> | 各ディメンションのレベルの合計。 |
<btcsky_visitor_count> | 現在島にいる訪問者。 |
<btcsky_biome_current> | プレイヤーのいる場所のバイオーム名。 |
<btcsky_season> | 現在のディメンションのシーズン。島の外では、カレンダーの日付のシーズン。 |
<btcsky_setting:name> | 設定の、色付きのオン/オフの状態: visit(または open)、fly、pvp、mobs、explosions、fire、world_border、possession_border。 |
<btcsky_island_exp> は常に 0、<btcsky_island_level_progress> は常に 100、<btcsky_bank_interest_rate> は常に 0.0 を返します。これらは互換性のためだけに存在します。
サイズ、バイオーム、カウント
| プレースホルダー | 返す値 |
|---|---|
<btcsky_size> | 現在のディメンションで解放されているチャンク。 |
<btcsky_island_size> | すべてのディメンションで解放されているチャンク。 |
<btcsky_size_max>, <btcsky_max_size> | 現在のディメンションの、テンプレートによる最大チャンク数。 |
<btcsky_island_size_max>, <btcsky_island_max_size> | すべてのディメンションにわたる最大チャンク数。 |
<btcsky_biomes_acquired>, <btcsky_island_biomes_total> | すべてのディメンションで解放されているバイオーム。 |
<btcsky_biomes_total> | すべてのディメンションにわたって存在できるバイオーム。 |
<btcsky_biomes:group> | 現在のディメンションで解放されている、バイオームグループのバイオーム。 |
<btcsky_island_biomes:group> | すべてのディメンションで解放されている、バイオームグループのバイオーム。 |
<btcsky_block_count:MATERIAL> | 現在のディメンションでの、ブロックの数。 |
<btcsky_upgrade_level:id> | 現在のディメンションでの、アップグレードのレベル。 |
<btcsky_upgrades_acquired>, <btcsky_upgrades_total> | すべてのディメンションにわたる、購入済みのアップグレードと、利用可能なアップグレード。 |
<btcsky_warp_count>, <btcsky_warp_list> | ワープの数と名前。 |
<btcsky_warp_limit> | 設定のデフォルトのワープ制限。 |
進行と社交
| プレースホルダー | 返す値 |
|---|---|
<btcsky_contract_completed_count> | 完了した契約。 |
<btcsky_research_unlocked_nodes>, <btcsky_research_unlocked_count> | 解放されたリサーチノード。 |
<btcsky_research_points> | リサーチポイント。 |
<btcsky_collection_total_unlocked> | 解放されたコレクション。 |
<btcsky_collection_progress:id> | コレクション ID で収集された量。 |
<btcsky_ban_count> | BAN されたプレイヤー。 |
<btcsky_rating>, <btcsky_rating_count> | 平均評価(小数点以下 1 桁)と投票数。 |
<btcsky_combat_wins>, <btcsky_combat_losses>, <btcsky_combat_draws>, <btcsky_combat_winrate> | 戦争の統計と、パーセントでの勝率。 |
ディメンション
引数は、ディメンション ID または current です。
| プレースホルダー | 返す値 |
|---|---|
<btcsky_dimension_id:dim>, <btcsky_dimension_display:dim> | ディメンション ID と、先頭を大文字にした表示名。 |
<btcsky_dimension_unlocked:dim>, <btcsky_dimension_is_locked:dim> | true または false。 |
<btcsky_dimension_level:dim> | ディメンションのレベル。 |
<btcsky_dimension_generator_tier:dim> | ジェネレーターのティア。 |
<btcsky_dimension_event_next:dim> | 次のイベントまでの時間(mm:ss)、Now、または Unknown。 |
<btcsky_dimension_size:dim>, <btcsky_dimension_size_max:dim> | 解放されたチャンクと、最大チャンク数。 |
<btcsky_dimension_biomes_total:dim> | 解放されたバイオーム。 |
<btcsky_dimension_upgrades_acquired:dim>, <btcsky_dimension_upgrades_total:dim> | 購入済みのアップグレードと、利用可能なアップグレード。 |
<btcsky_dimension_visitor_count:dim> | ディメンション内の訪問者。 |
<btcsky_dimension_upgrade_level:dim:id> | ディメンション内でのアップグレードのレベル。 |
<btcsky_dimension_biomes:dim:group> | ディメンション内で解放されている、グループのバイオーム。 |
<btcsky_block_limit:dim:MATERIAL> | ディメンション内でのブロックの制限。 |
<btcsky_dimension_lock_mark:dim> | ディメンションがロックされている場合は [X] 、開いている場合は空。 |
<btcsky_dimension_locked_palette:dim> | メニューボタン用の、ロック中または開いているディメンションのパレット名。 |
メニュー
コントロールパネルは、ビューを持つ 1 つのメニューです。
- BTC Sky Menu は、
layoutPool、views(画面ごとに 1 つ)、defaultViewId、inventoryRowsを保持します。タブのスロットはタグview:<viewId>を持ち、可変コンテンツのフレームはレイアウト ID@viewを使います。ビューは、<viewId>または<viewId>:<argument>(たとえばcollection_detail:mining)で開きます。 - コンテンツのアイテムは、
btcsky_button:TYPEの形式のbuttonTypeを使います。拡張機能が、ライブデータ(島の情報、ディメンション、アップグレード、コレクション、ランキング、ワープ、契約、メンバー、BAN、リサーチ、拡張チャンク、ボーダー、戦闘、ホログラムなど)を埋め込み、クリックを割り当てます。 - BTC Sky Menu Configuration は、動的リストのアイテムテンプレートを保持します。
- Open Specific Menu は指定したビューを開き、Open Friends Menu はフレンドの画面を開きます。
グローバルメニューから開いた場合、パネルはカタログです(見て回れますが、何も購入できません)。安定化クリスタルから開いた場合は、ディメンションのコントロールルームとなり、アップグレードとチャンクの購入が可能になります。それ以外では、購入コマンドは拒否されます。
UiCore がインストールされている場合、BTC Sky は、リスト(アップグレード、拡張マップ、訪問、コレクション、ランキング、メンバー、ボーダー)を UiCore のメニューにも公開し、個体数の上限によってスポーンが拒否されたときにバナーを表示します。
エントリ
161 件のエントリー(拡張機能のソースから生成)。
アクション61
- Archipel Build Bridge ActionArchipel : bâtir une passerelle
- Archipel Grant Access ActionArchipel : accorder l'accès
- Archipel Raise Tier ActionArchipel : monter un îlot d'un palier
- Btcsky Add RatingAdd rating to island
- Btcsky Apply EffectApply island effect
- Btcsky Decline InviteDecline island invite
- Btcsky Invite Coop PartnerInvite a player to start a Coop
- Btcsky Leave CoopLeave cooperative island
- Btcsky MenuBTC Sky Menu
- Btcsky Open Friends MenuOpens the friends menu for the player
- Btcsky Open MenuOpen specific menu
- Btcsky Remove EffectRemove island effect
- Btcsky Reset UpgradesReset all upgrades
- Btcsky Set Dimension BiomeSet dimension biome
- Btcsky Set Generator TierSet generator tier
- Btcsky Set TimeSet dimension time
- Btcsky Set Upgrade LevelSet upgrade level (admin)
- Btcsky Switch Next DimensionCycle to next unlocked island dimension
- Btcsky Teleport Random IslandTeleport to random public island
- Btcsky Teleport to PlayerTeleport to player on island
- Btcsky Toggle Warp PublicToggle warp visibility
- Btcsky Upgrade GeneratorUpgrade generator one tier
- Create Island ActionCreate Island
- Create Named HologramCreate a hologram from menu input
- Create Named WarpCreate a named warp from menu input
- Create Warp ActionCreate Island Warp
- Delete Island ActionDelete Island
- Delete Named HologramDelete a hologram from menu
- Delete Warp ActionDelete Island Warp
- Demote Member ActionDemote Member
- Edit Named HologramEdit a hologram from menu input
- Initiate Guild WarInitiates a Guild War instance directly via ASPaper.
- Invite Member ActionInvite Member
- Invite Named PlayerInvite a player by name from menu input
- Island Accept Invite ActionAccepts a pending island invitation
- Island Ban PlayerBan a player from the island
- Island Bank DepositDeposits money into island bank
- Island Bank WithdrawWithdraw money from island bank
- Island Calculate LevelRecalculate island level
- Island Rename WarpRename an island warp
- Island Research ActionUnlock a research node
- Island Reset ActionResets the player's island (Delete & Re-create)
- Island Set BiomeSet the island's biome
- Island Set HomeSet island home location
- Island Set WeatherSet dimension weather
- Island Show BorderVisually show island border
- Island Teleport DimensionTeleport to specific dimension
- Island Teleport SpawnTeleport to server spawn
- Island Toggle FlyToggle Fly mode on the island
- Island Toggle PVPToggle PvP on the island
- Island Upgrade ActionPurchase an upgrade for the island
- Kick Member ActionKick Member
- Leave Island ActionLeave Island
- Move Island NPC ActionDéplacer un habitant de l'île
- Open Research MenuOpen a research menu for the player
- Promote Member ActionPromote Member
- Research Grant PointsGrant research points to the player's island
- Research Grant XPGrant experience to a research category
- Teleport Home ActionTeleport Home
- Unlock Collection ActionUnlock/Lock Collection
- Unlock Dimension ActionUnlock Island Dimension
イベント33
- Btcsky Block Broken EventWhen a block is broken on the island
- Btcsky Block Limit Reached EventWhen block limit is reached
- Btcsky Block Placed EventWhen a block is placed on the island
- Btcsky Combat End EventWhen island combat ends
- Btcsky Combat Start EventWhen island combat starts
- Btcsky Coop Invite Accepted EventWhen a coop invitation is accepted
- Btcsky Coop Invite Declined EventWhen a coop invitation is declined
- Btcsky Coop Invite Sent EventWhen a coop invitation is sent
- Btcsky Coop Partner Left EventWhen a coop partner leaves
- Btcsky Entity Limit Reached EventWhen entity limit is reached
- Btcsky Generator Used EventWhen a cobblestone generator is used
- Btcsky Island Enter EventWhen a player enters any island
- Btcsky Island Event EndWhen a random island event ends
- Btcsky Island Event StartWhen a random island event starts
- Btcsky Island Leave EventWhen a player leaves an island
- Btcsky Island Visit EventWhen a player visits another player's island
- Btcsky Level Up EventWhen island level increases
- Btcsky Member Banned EventWhen a player is banned from the island
- Btcsky Member Demoted EventWhen a member is demoted
- Btcsky Member Join EventWhen a new member joins the island
- Btcsky Member Kicked EventWhen a member is kicked
- Btcsky Member Leave EventWhen a member leaves the island
- Btcsky Member Promoted EventWhen a member is promoted
- Btcsky Member Unbanned EventWhen a player is unbanned
- Btcsky Research Complete EventWhen a research is completed
- Btcsky Season Change EventWhen the island season changes
- Btcsky Top Reached EventWhen island enters top rankings
- Btcsky Warp Create EventWhen an island warp is created
- Btcsky Warp Delete EventWhen an island warp is deleted
- Island Bank Transaction EventTriggered on bank transactions
- On Island CreateTriggered when a player creates an island
- On Island Dimension EnterWhen player enters an island dimension
- On Island UpgradeWhen an island upgrade is purchased
目標1
- Coop Countable ObjectiveA countable objective that scales its target for coop islands
ファクト38
- Archipel Access FactArchipel : accès accordé
- Archipel Bridge FactArchipel : passerelle bâtie
- Archipel Bridges FactArchipel : passerelles bâties
- Archipel Progression FactArchipel : progression totale
- Archipel Tier FactArchipel : palier de l'îlot
- Btcsky Block Count FactCount of specific block/material
- Btcsky Block Limit FactLimit for specific block/material
- Btcsky Dimension Is Primary FactDimension is primary/home
- Btcsky Dimension Unlocked FactDimension is unlocked
- Btcsky Entity Count FactCount of specific entity type
- Btcsky Entity Limit FactLimit for specific entity type
- Btcsky Fly Enabled FactIf fly is enabled (upgrade/setting)
- Btcsky Generator Tier FactGenerator tier for dimension
- Btcsky Has Island FactPlayer has an island
- Btcsky Has Upgrade FactHas upgrade (level > 0)
- Btcsky Is Coop Island FactIsland is cooperative
- Btcsky Is in Void FactPlayer is in the void (Y < -64)
- Btcsky Is Island Admin FactPlayer is island admin or higher
- Btcsky Is Island Member FactPlayer is island member or higher
- Btcsky Is Island Moderator FactPlayer is island moderator or higher
- Btcsky Is Island Owner FactPlayer is island owner
- Btcsky Is on Any Island FactPlayer is on valid island world
- Btcsky Is on Island FactPlayer is on their own island
- Btcsky Is Visitor FactPlayer is visiting another island
- Btcsky Island Age FactIsland age in days
- Btcsky Island Balance FactIsland bank balance
- Btcsky Island Rating FactIsland average rating
- Btcsky Member Count FactNumber of island members
- Btcsky Member Role FactPlayer's island role (ordinal)
- Btcsky Online Member Count FactNumber of online island members
- Btcsky Upgrade Level FactLevel of specific upgrade
- Btcsky Warp Count FactNumber of warps in dimension
- Contract Completion FactReturns the number of contracts completed by the player
- Island Block Count FactCount specific blocks on an island dimension
- Island Dimension ActivityGet last activity timestamp for an island dimension
- Island Level FactCheck Island Level
- Island NPC PositionStores island npc position per dimension
- Island Role FactCheck Island Role
エンティティ1
- Island NPC InstanceNpc instance per island dimension
アクティビティ1
- Btcsky Runtime PathRuntime Path Activity
グループ2
- Btcsky Island GroupGroups players by their BTCSky island (Global)
- Btcsky Role GroupGroups players by their BTCSky island and role
アーティファクト1
- Player Sky Data ArtifactGlobal BTC Sky Data Storage
マニフェスト20
- Btcsky Bettermodel Impact MechanicBetterModel Impact Mechanic
- Btcsky Boss MechanicBoss Mechanic
- Btcsky ConfigBTC Sky Main Configuration
- Btcsky Coop Buff MechanicCoop Buff Mechanic
- Btcsky Dimension TemplateIsland Dimension Template
- Btcsky Eclipse MechanicEclipse Mechanic
- Btcsky Event Ambience MechanicEvent Ambience Mechanic
- Btcsky Event Flag MechanicIsland Event Flag
- Btcsky Event Trigger MechanicEvent Trigger Mechanic
- Btcsky Island EventIsland Event
- Btcsky Menu ConfigBTC Sky Menu Configuration
- Btcsky Meteor Shower MechanicMeteor Shower Mechanic
- Btcsky Mob Wave MechanicMob Wave Mechanic
- Btcsky PermissionsBTC Sky Permission Definitions
- Btcsky Research BranchResearch Branch
- Btcsky Research NodeResearch Node
- Btcsky Storm MechanicStorm Mechanic
- Btcsky Temporary Client Block MechanicTemporary Client Block Mechanic
- Btcsky Temporary Multiplier MechanicTemporary Multiplier Mechanic
- Btcsky Treasure Rain MechanicTreasure Rain Mechanic
定義1
- Island Dimension Road NetworkRoad network shared across BTC Sky dimensions
その他のエントリー2
- Btcsky InstanceSpawns an Entity Instance in a specific Island Dimension.
- Btcsky NPC Reference BlockNPC Reference Block
トラブルシューティング
島のワールドが作成されない。 各ディメンションは、slime_worlds フォルダから、templateWorldName に指定された名前のワールドを複製します。ファイルが存在し、BTC Core が Advanced Slime Paper を提供している必要があります。サーバーログで、ディメンション ID と島の ID を確認してください。
プロファイルを作成した後に、プレイヤーに島がない。 autoProvisionIslandOnProfileCreation は、デフォルトではオフです。Create Island アクションをトリガーするか、オプションをオンにしてください。
/island が存在しない。 拡張機能が登録するのは /typewriter island だけです。BTC Sky Menu をトリガーする独自のコマンドを作成してください。また、Contracts Table が開くメニューエントリの ID は、control_panel でなければなりません。
契約が開かない。 contractsRequireWorkstation がオンの場合、契約は Contracts Table(contractsTableEnabled と contractsTableBlock)からしか開きません。テストサーバーではオフにするか、バイパス権限を与えてください。
すべてのプレースホルダーが 0 を返す。 プレイヤーに島がないか、アクティブなプロファイルがありません。<btcsky_has_island> と <btcsky_context_state> を確認してください。ディメンションの引数は、有効なディメンション ID または current でなければなりません。
リサーチツリーが表示されない。 リサーチの実行時は、メイン設定の research.branches と research.nodes を読み取ります。Research Branch と Research Node のエントリは読み取られません。
シーズンやイベントがまったく始まらない。 シーズンはデフォルトで無効です(seasons.enabled)。イベントには、テンプレートの events.events に少なくとも 1 つのイベントが必要で、イベントは、その conditions、requiredUpgradeId、minimumPlayers が一致した場合にのみ発火します。
島にモブがスポーンしない。 spawner.enabled、maxNearbyMobs、maxPerChunk と、島のフラグ IS_MOB_SPAWNING_ENABLED を確認してください。/typewriter island admin limit show <profileId> で、カウンターを、実際のモブの数と比較します。
共有ワールドでプレイヤーが建築できない。 readOnlyWorlds(デフォルトは archipel_metiers)に列挙されたワールドは、machine.protection.bypass の保持者を除いて、全員に対して保護されます。