-----English Version-----

Overview

This add-on includes features to eliminate minor inconveniences that can sometimes be encountered while playing Minecraft.
These features can be broadly divided into those that are activated by entering a special message in the chat box, and those that are activated by using a specific item ("using an item" refers to right-clicking while holding the item in your right hand).

Definition of Terms

・"Command": A message sent in the chat box that executes a certain function.
・"Item and Function Linked": An item that executes a certain function when used.
・"Tool": An item that is linked to a function.
・"tpPlaces": A collection of coordinates and their names stored as pairs.
・"tp": A function that teleports the player 100 meters in line of sight or to coordinates stored in tpPlaces.
・"coord": A function that checks block coordinates.
・"cleaner": A function that kills item entities and XP orbs around the player.
・"tpTool": A tool that executes tp.
・"coordTool": A tool that executes coord.
・"cleanerTool": A tool that executes cleaner.

List of Functions

tp

This function teleports the player 100 meters in line of sight or to coordinates stored in tpPlaces. This function is executed using both a tool and a command.

tpPlaces was implemented to make teleporting more intuitive and easier.
If you name the coordinates you frequently teleport to and register them in tpPlaces, you can teleport by typing the name instead of typing the coordinates in the chat box.
You can also register as many coordinates as you like in tpPlaces.
It's much easier to name and save the coordinates you frequently use than to memorize them all.
Furthermore, if you select one of the coordinates registered in tpPlaces and link it to a tpTool, you'll be able to teleport to that location simply by left-clicking with the tpTool.
- You can manage tpPlaces using the tpPlaces command.
Enter "tpPlaces add <coordinate name>" to register the player's coordinates, along with their name, in tpPlaces.
To delete a registered coordinate, enter "tpPlaces remove <coordinate name>".
If you want to delete all coordinates at once, enter "tpPlaces reset".
Alternatively, by entering "tpPlaces list", all registered coordinates will be displayed in the chat box along with their names.
Furthermore, by entering "tpPlaces combine <coordinate name>", you can link the coordinates corresponding to that name to a tpTool.
Incidentally, the coordinates registered in tpPlaces, their names, and the coordinates linked to tpTool will be maintained and not discarded even if you reload the add-on.
- Enter "tp <coordinate name>" to teleport to the coordinates registered in tpPlaces.
You can also return to your original location by entering "tp return" afterwards.
- Using a tpTool (default is Echo Shard) will teleport you 100m in the line of sight.
- Holding a tpTool and left-clicking will teleport you to the coordinates linked to the tpTool.

coord

This function checks the coordinates of a block and is executed using a tool.

- Holding the coordTool (default: Compass) in your right hand and destroying a block will display the block's ID in the chat box.

cleaner

This function kills item entities and XP orbs around the player and is executed using a tool.

- Using the cleanerTool (default: brush) will kill nearby item entities and XP orbs.

Other

- Executing the handItemId command displays the ID of the item held in your right hand in the chat box.
- The cfTool command allows you to associate items with functions.
Hold the item you want to associate in your right hand and enter "cfTool define <function name>" to associate that function with that item.
For example, if you want to assign tp to a stick, hold the stick in your right hand and enter "cfTool define tp".
By the way, the association between items and functions is maintained even if you reload the add-on.
Also, typing "cfTool reset" will reset all associations between items and functions.
In other words, tools will become the default item.
- Typing "help" in the chat field will display a list of this add-on's functions in the chat field.

*To use this add-on, you must enable experimental gameplay in the game.
*When using this add-on, I recommend enabling content log history in the settings.
("Settings" → "Creator" → "Enable Content Log GUI")
There are two types of error messages that may appear while using the add-on. The first is a user-related issue, which the add-on's program displays in red text in the chat box. The second is a this add-on's program-related issue, which the Minecraft program displays in white text in the upper left corner of the screen (this message will not appear unless Content Log GUI is enabled).
If you see a white text error message, it indicates a bug in the add-on. Please reload the add-on by executing the /reload command, and then please copy and paste the error message and the conditions under which it occurs in the comments section of this article.

-----日本語版-----

概要

マイクラプレイ中に時々感じる些細な不便さを解消するような機能が盛り込まれたアドオンです。
これらの機能は、チャット欄にて専用のメッセージを入力して実行するタイプのものと、特定のアイテムを使用する(「アイテムを使用する」とはアイテムを右手に持った状態で右クリックする事を指す)事で実行するタイプのものに大別されます。

用語の定義

・「コマンド」...チャット欄でそれを送信する事によってある機能を実行出来るメッセージ
・「アイテムと機能が紐付けられている」...あるアイテムを使用した際にある機能を実行出来る事
・「ツール」...機能と紐付いているアイテム
・「tpPlaces」...いくつかの座標とその名前をペアで保存しているもの
・「tp」...プレイヤーを視線方向の100m先またはtpPlacesに保存されている座標にテレポートさせる機能
・「coord」...ブロックの座標を調べる機能
・「cleaner」...プレイヤーの周囲に存在するアイテムエンティティ及びxpオーブをkillする機能
・「tpTool」...tpを実行するツール
・「coordTool」...coordを実行するツール
・「cleanerTool」...cleanerを実行するツール

機能一覧

tp

プレイヤーを視線方向の100m先またはtpPlacesに保存されている座標にテレポートさせるものであり、ツールとコマンドの両方を用いて実行する機能です。

tpPlacesは、より直感的であり、なおかつ楽なテレポートを可能にするために実装されたものです。
頻繁にテレポートする座標を名前を付けてtpPlacesに登録しておけば、チャット欄に座標を打ち込む代わりに名前を打ち込む事でテレポートが出来ます。
また、tpPlacesには好きなだけ座標を登録する事が出来ます。
よくtpする座標を全て暗記するよりも、あらかじめ名前を付けて保存しておいた方がはるかに楽です。
更に、tpPlacesに登録されている座標のうちどれか1つを選んでそれをtpToolに紐づければ、tpToolを持って左クリックするだけでそこへtp出来るようになります。

・tpPlacesコマンドを用いる事によって、tpPlacesの管理を行えます。
「tpPlaces add <座標の名称>」と入力し、それを入力した際のプレイヤーの座標を名称と共にtpPlacesに登録します。
登録済みの座標を削除したい場合は「tpPlaces remove <座標の名称>」と入力します。
もし全ての座標を一気に削除したいなら、「tpPlaces reset」と入力します。
また、「tpPlaces list」と入力すれば、登録済みの全ての座標をその名称と共にチャット欄に表示する事が出来ます。
更に、「tpPlaces combine <座標の名称>」と入力すれば、その名称に対応する座標をtpToolに紐づける事が出来ます。
ちなみに、tpPlacesに登録されている座標とその名称及びtpToolに紐づけられている座標は、アドオンを再読み込みしても破棄されず、維持されます。
・「tp <座標の名称>」と入力して、tpPlacesに登録されている座標のもとへテレポートします。
また、その後に「tp return」と入力すれば元居た場所に戻る事が出来ます。
・tpTool ( デフォルトでは残響の破片 ) を使用すると視線方向の100m先にテレポートします。
・tpToolを持って左クリックすると、tpToolに紐づけられている座標にテレポートします。

coord

ブロックの座標を調べるもので、ツールを用いて実行する機能です。

・coordTool ( デフォルトではコンパス ) を右手に持ってブロックを破壊するとブロックのIDをチャット欄に表示します。

cleaner

プレイヤーの周囲に存在するアイテムエンティティ及びxpオーブをkillするもので、ツールを用いて実行する機能です。

・cleanerTool ( デフォルトではブラシ ) を使用すると、周辺のアイテムエンティティ及びxpオーブをkillします。

その他

・handItemIdコマンドを実行すると右手に持っているアイテムのIDがチャット欄に表示されます。
・cfToolコマンドを使用する事により、アイテムと機能の紐付けに関する設定が可能です。
紐付けたいアイテムを右手に持った状態で、「cfTool define <機能の名称>」と入力すれば、その機能とそのアイテムが紐付けられます。
例えば、tpを棒に割り当てたい場合は、棒を右手に持った状態で「cfTool define tp」と入力します。
ちなみに、アイテムと機能の紐付き状況は、アドオンを再読み込みしても維持されます。
また、「cfTool reset」と入力すると、アイテムと機能の全ての紐付きを初期化します。
つまり、デフォルトのアイテムがツールになります。
・チャット欄でhelpと入力すると当アドオンの機能の一覧をチャット欄に表示します。

※このアドオンを使用するにはゲーム内で試験的なゲームプレイを有効にする必要があります。
※当アドオンを使用する際は、設定でコンテンツログの履歴を有効化しておく事を推奨します。
(「設定」→「クリエイター」→「コンテンツログGUIの有効化」)
アドオン使用中に表示される可能性のあるエラーメッセージは2種類あり、1つ目はユーザー側の問題で当アドオンのプログラムがチャット欄に赤文字で表示するエラーメッセージであり、2つ目は当アドオンのプログラム側の問題でマイクラ自体のプログラムが画面左上に表示する白文字のエラーメッセージ(コンテンツログGUIを有効化していないと表示されないメッセージ)です。
白文字のエラーメッセージが表示された場合、当アドオンにバグが存在するという事になりますので、/reloadというコマンドを実行しアドオンを再読み込みしていただいた後、当記事のコメント欄にてエラーメッセージのコピペとその発生条件をご報告していただけると助かります。

Convenient Functions(便利機能)