装飾コードのソースを表示

{{about|従来の§ベースのフォーマットシステム|最新のJSONシステム|Raw JSONテキストフォーマット}}

[[ファイル:Minecraft Formatting.gif|サムネイル|使用可能な書式で記述された本。]]

'''装飾コード'''（英：Formatting codes）は、[[Wikipedia:ja:節記号|節記号]]（<code>§</code>）を用いて文字列の色や装飾を変更する手法である。

{{in|be}}、節記号は[[看板]]、[[ワールド]]名、[[本と羽根ペン]]、[[金床]]・[[製図台]]でのアイテム改名、[[チャット]]（{{cmd|say}}などメッセージ[[コマンド]]を含む）で使用できる。

{{in|je}}、<samp>[[server.properties]]</samp>、<samp>[[pack.mcmeta]]</samp>、<samp>[[Splash|splashes.txt]]</samp>、[[言語のカスタマイズ|言語定義ファイル]]、ワールド名、[[データパック]]内から実行するメッセージコマンド（[[関数 (Java Edition)|関数]]内の{{cmd|tellraw}}など）で使用できる。

[[ツールとエディター|外部ツール]]を用いることでそれ以外の箇所でも使用可能になる。

== 用途 ==
文字列は § 記号とその後に1文字を使い装飾を指定できる。メッセージ内の § 記号とそれに続く16進数は、表示時に文字列の色を変更するようにクライアントに指定する。{{IN|bedrock}}、§ 記号は任意の文字列入力で使用できるが、{{in|java}}、<samp>[[server.properties]]</samp>、<samp>[[pack.mcmeta]]</samp>、ワールド名、サーバー名で使用できる。

装飾コードの指定後にカラーコードを指定すると、装飾コードはその色指定以降は無効となる。<br>
例えば「<code>§cX§nY</code>」とすると「<span class="format-c" style="font-family: Minecraft;">X<u>Y</u></span>」となり、「<code>§nX§cY</code>」とすると「<span class="format-f" style="font-family: Minecraft"><u>X</u><span class="format-c">Y</span></span>」になる。したがって、装飾コードとともにカラーコードを使用して色を変更したい場合は、最初にカラーコードを指定しなければならない。

[[File:Motd scramble bug.png|thumb|400px]]
{{IN|bedrock}}、装飾コードはカラーコードの後も有効になる。さらに <code>§k</code> を指定して行の終わりの前に <code>§r</code> が使用されない場合、クライアントGUIはMOTDを超えて、バージョン番号表示の文字列もObfuscatedを続ける。

=== カラーコード ===
[[ファイル:Colors.png|サムネイル|16進数と色の対応表。「§」の後に色に対応した数字か文字を指定する。例えば「§e」で黄色になる。]]

サーバーからクライアントへ向け送られるメッセージには、カラーコードで着色することができる。この色指定された文字列は様々な用途に用いることが可能だ。

{| class="fandom-table wikitable" style="text-align: center;" data-description="Color codes"
|-
! rowspan=2 | コード
! rowspan=2 | 技術名称
! colspan=4 | 前景色
! colspan=4 | 背景色
! rowspan=2 | バージョン
|-
! R !! G !! B !! <abbr title="16進数カラーコード">Hex</abbr>
! R !! G !! B !! <abbr title="16進数カラーコード">Hex</abbr>
|-
| §0
| black
| 0 || 0 || 0 || style="text-align: left;" | {{color|#000000}}
| 0 || 0 || 0 || style="text-align: left;" | {{color|#000000}}
|
|-
| §1
| dark_blue
| 0 || 0 || 170 || style="text-align: left;" | {{color|#0000AA}}
| 0 || 0 || 42 || style="text-align: left;" | {{color|#00002A}}
|
|-
| §2
| dark_green
| 0 || 170 || 0 || style="text-align: left;" | {{color|#00AA00}}
| 0 || 42 || 0 || style="text-align: left;" | {{color|#002A00}}
|
|-
| §3
| dark_aqua
| 0  || 170 || 170 || style="text-align: left;" | {{color|#00AAAA}}
| 0 || 42 || 42 || style="text-align: left;" | {{color|#002A2A}}
|
|-
| §4
| dark_red
| 170 || 0 || 0 || style="text-align: left;" | {{color|#AA0000}}
| 42 || 0 || 0 || style="text-align: left;" | {{color|#2A0000}}
|
|-
| §5
| dark_purple
| 170 || 0 || 170 || style="text-align: left;" | {{color|#AA00AA}}
| 42 || 0 || 42 || style="text-align: left;" | {{color|#2A002A}}
|
|-
| rowspan=2 | §6
| rowspan=2 | gold
| rowspan=2 | 255 || rowspan=2 | 170 || rowspan=2 | 0 || rowspan=2  style="text-align: left;" | {{color|#FFAA00}}
| 42 || 42 || 0 || style="text-align: left;" | {{color|#2A2A00}}
| {{only|je|short=1}}
|-
| 64 || 42 || 0 || style="text-align: left;" | {{color|#402A00}}
| {{only|be|short=1}}
|-
| §7
| gray
| 170 || 170 || 170 || style="text-align: left;" | {{color|#AAAAAA}}
| 42 || 42 || 42 || style="text-align: left;" | {{color|#2A2A2A}}
|
|-
| §8
| dark_gray
| 85 || 85 || 85 || style="text-align: left;" | {{color|#555555}}
| 21 || 21 || 21 || style="text-align: left;" | {{color|#151515}}
|
|-
| §9
| blue
| 85 || 85 || 255 || style="text-align: left;" | {{color|#5555FF}}
| 21 || 21 || 63 || style="text-align: left;" | {{color|#15153F}}
|
|-
| §a
| green
| 85 || 255 || 85 || style="text-align: left;" | {{color|#55FF55}}
| 21 || 63 || 21 || style="text-align: left;" | {{color|#153F15}}
|
|-
| §b
| aqua
| 85 || 255 || 255 || style="text-align: left;" | {{color|#55FFFF}}
| 21 || 63 || 63 || style="text-align: left;" | {{color|#153F3F}}
|
|-
| §c
| red
| 255 || 85 || 85 || style="text-align: left;" | {{color|#FF5555}}
| 63 || 21 || 21 || style="text-align: left;" | {{color|#3F1515}}
|
|- <!--「Light Purple」はゲーム内での名称のため、「Pink」には変更しないでください -->
| §d
| light_purple
| 255 || 85 || 255 || style="text-align: left;" | {{color|#FF55FF}}
| 63 || 21 || 63 || style="text-align: left;" | {{color|#3F153F}}
|
|-
| §e
| yellow
| 255 || 255 || 85 || style="text-align: left;" | {{color|#FFFF55}}
| 63 || 63 || 21 || style="text-align: left;" | {{color|#3F3F15}}
|
|-
| §f
| white
| 255 || 255 || 255 || style="text-align: left;" | {{color|#FFFFFF}}
| 63 || 63 ||  63 || style="text-align: left;" | {{color|#3F3F3F}}
|
|-
| §g
| minecoin_gold
| 221 || 214 || 5 ||style="text-align: left;" | {{color|#DDD605}}
| 55 ||  53 || 1 || style="text-align: left;" | {{color|#373501}}
| {{only|be|short=1}}
|-
|}

=== 装飾コード ===

{| class="wikitable" style="text-align: center;" border="1" cellpadding="5" data-description="Formatting codes"
|-
! width="8" colspan="1" | コード
! colspan="1" | 公式名称
! [[Bedrock Edition|Bedrock]]との互換性
! [[Java Edition|Java]]との互換性
|-
| §k || Obfuscated
| はい
| はい
|-
| §l || '''Bold'''
| はい
| はい
|-
| §m || <s>Strikethrough</s>
| いいえ<ref name="formatting bug">{{bug|MCPE-41729}}</ref>
| はい
|-
| §n || <u>Underline</u>
| いいえ<ref name="formatting bug"/>
| はい
|-
| §o || ''Italic''
| はい
| はい
|-
| §r || Reset
| はい
| はい
|-
|}

<code>§k</code> 指定後に表示される不作為に選ばれる文字は、常にもともとの文字と同じ幅になる。例えば、「m」を指定するとその幅のランダムな文字が繰り返し表示されるが、「i」ではその幅に限られた文字しか表示されない。

<code>§r</code> を指定することで、その場所以前の装飾コード指定をすべて取り消すことができる。例えば「<code>§nXXX§rYYY</code>」とすると「<span class="format-f" style="font-family: Minecraft"><u>XXX</u>YYY</span>」となる。

=== 入力 ===
{{see also|Wikipedia:Unicode input}}

* ほとんどのUS/UKキーボード (英語キーボード) を備えたWindowsで「§」を入力するには、{{keys|Alt+2|1}} (cp437のaltコード) と入力する。その他のキーボードの場合、{{keys|Alt+0|1|6|7}} (いずれもテンキーの数字を用いること) と入力する。
* Windowsレジストリで <abbr title="HKEY_CURRENT_USER\Control Panel\Input Method"><code>EnableHexNumpad</code></abbr> が有効になっている場合、{{keys|Alt+<nowiki>+</nowiki>|A|7}} (メインキーボードの「A」を使用) はUnicodeであるため、どの言語でも機能する。
* USキーボードを搭載したMacでは {{keys|Option+6}} (US 拡張では {{keys|Option+5}}) と入力する。その他のキーボードの場合は、{{keys|Option+0|0|a|7}}と入力する。
* LinuxでComposeキーが有効になっている場合は、{{keys|Compose|s|o}}と入力する。記号は、Unicodeショートカットを使用して入力することもできる：{{keys|Control+Shift+u|0|0|a|7}}
* このページから文字をコピーし、本に貼り付けるには {{keys|Ctrl+V}} とする。ただし、チャット欄やコマンドブロックの GUI などでは貼り付けることはできない。
* <!--日本-->日本語版Windowsの日本語キーボードでは {{key|Alt+3|3|1|7|6}} とする。かな漢字変換が有効であれば、セクションを変換することで「§」を入力可能だ (MS IME の場合)。ただし ''Minecraft'' そのものはIMEに対応していないので、コピー&ペーストで対応するか、[[Mod]]を用いる必要がある。<!--/日本-->

=== サンプルテキスト ===

以下の文字列は、[[本と羽根ペン]]にコピー&ペーストすることで以下の画像のように表示される:

{|
|-
| [[ファイル:Minecraft Formatting.gif|200px|292:360]]
|
<pre>§nMinecraft Formatting§r

§00 §11 §22 §33
§44 §55 §66 §77
§88 §99 §aa §bb
§cc §dd §ee §ff

§rk §kMinecraft
§rl §lMinecraft
§rm §mMinecraft
§rn §nMinecraft
§ro §oMinecraft
§rr §rMinecraft</pre>
|-
|}

== server.propertiesやpack.mcmetaでの使用 ==

MOTD で着色や装飾をするには、§ の代わりに <code>\u00A7</code> を使用する必要がある。そのため、§5 を使うには <code>\u00A75</code> とする。装飾と着色は併用することができるが、装飾は着色の'''後'''にしなくてはならない。一覧は以下のとおりである。

{| class="wikitable" style="text-align: center;" data-description="Codes without 'section' symbol"
|-
! コード !!  公式名称 !! <abbr title="Message of the Day">MOTD</abbr> コード !! Note
|-
| §0 || Black || \u00A70 ||
|-
| §1 || Dark Blue || \u00A71 ||
|-
| §2 || Dark Green || \u00A72 ||
|-
| §3 || Dark Aqua || \u00A73 ||
|-
| §4 || Dark Red || \u00A74 ||
|-
| §5 || Dark Purple || \u00A75 ||
|-
|§6
|Gold
|\u00A76
|
|-
| §7 || Gray || \u00A77 ||
|-
| §8 || Dark Gray || \u00A78 ||
|-
| §9 || Blue || \u00A79 ||
|-
| §a || Green || \u00A7a ||
|-
| §b || Aqua || \u00A7b ||
|-
| §c || Red || \u00A7c ||
|-
| §d || Light Purple || \u00A7d ||
|-
| §e || Yellow || \u00A7e ||
|-
| §f || White || \u00A7f ||
|-
| §k || Obfuscated || \u00A7k ||
|-
| §l || '''Bold''' || \u00A7l ||
|-
| §m ||<s>Strikethrough</s> || \u00A7m || {{Only|java}}
|-
| §n ||<u>Underline</u> || \u00A7n || {{Only|java}}
|-
| §o || ''Italic'' || \u00A7o ||
|-
| §r || Reset || \u00A7r ||
|-
| \n || New line || \n || {{fn|Raw JSON only.}}
|-
|}
{{fnlist}}

=== 古いバージョンとの互換性 ===

装飾コードは、server.properties ファイルの <code>motd</code> の行で使用できるが、節記号は <code>\u00A7</code> としてエスケープする必要がある。節記号を直接入力したとしても、サーバーはそれを <code>\u00C2\u00A7</code> (Â§) に置換する。<br>
クライアントでは、疑問符の文字が \u00C2 と表示され、それが複数続いてある場合は、MOTD では \u00C2 が削除される。これは互換性がない場合に発生する。

== 言語パックでの使用 ==

言語ファイルでは、上記同様 <code>§</code> を使用することで名前や説明文の装飾、着色を施すことができる。また、<code>end.txt</code> と <code>credits.json</code> でもこれを使用できる。例えば、ダイヤモンドの名前を <code>§dダイヤモンド§r</code> とすることで、<span class="format-d" style="font-family: Minecraft">ダイヤモンド</span> と見えるようにできる。

== ワールド名での使用 ==

通常は不可能だが、NBTExplorer などの外部ツールを用いることで、ワールド名に装飾や着色ができる。これを行うには、ワールドの <samp>[[level.dat]]</samp> に <samp>LevelName</samp> タグを選択すれば良い。以下は、<samp>LevelName</samp> を設定した例である:

<code>§1R§2e§3d§4s§5t§6o§7n§8e §9C§ar§be§ca§dt§ei§fo§1n§2s</code>

[[ファイル:ColouredLevel.png]]

これはまた、ワールドのフォルダ名にコードを加える事でも可能である。ワールド選択画面では、指定された色や装飾が表示される。

これと同様に、リソースパックでも <samp>§</samp> を用いて装飾、着色ができる。

{{IN|bedrock}}、ワールドを作成するときにワールド名内で <samp>§</samp> を使用することができる。これにより、ゲームに変更を加えることなく、ワールド名内で装飾コードを使用できる。

== サーバー名での使用 ==

NBTExplorer などの外部ツールを用いることで、サーバー名を着色することが可能である。{{cd|[[.minecraft]]}} ディレクトリにある {{cd|[[servers.dat]]}} ファイルに {{cd|Name}} 属性を選択してこれが行える。以下は、{{cd|Name}} タグを設定した例である:

<code>§4§lMinecraft §6§lServer</code>

[[ファイル:ColouredServer.PNG]]

== 歴史 ==
[[ファイル:Obfuscated Text Comparison.gif|thumb|400px]]
{{Expand section|いつ追加されたか、いつ & が § に変更されたか、いつ置き換えられたかなどの情報を含むテンプレートへの変換（英語版より）}}
<code>§k</code> は[[Java Edition Beta 1.8|Beta 1.8]]で導入された後、{{in|java}}3回変更された。右側は、<code>§k</code> が指定された<code>1234567890abcdefghijklmnopqrstuvwxyz~!@#$%^&*()-=_+{}[]</code>の文字が4つの異なるバージョンでどのように見えるかの画像である。

== トリビア ==

* The color codes almost exactly match, in order, the 16 colors available using a [[wikipedia:Color Graphics Adapter#Color palette|Color Graphics Adapter (CGA)]], as released in 1981. Only color 6 differs; the value for color 6 in Minecraft – {{color|#FFAA00}} – differs from that made for CGA – {{color|#AA5500}}.
* In [[Legacy Console Edition]], <code>\n</code> worked outside of Raw JSON, although <code>\n</code> would still be in the text, with the new line after <code>\n</code> in the text.

== 脚注 ==
{{reflist}}

{{minecraft}}

{{デフォルトソート:そうしよくこおと}}
[[カテゴリ:開発]]

[[de:Formatierungscodes]]
[[en:Formatting codes]]
[[es:Códigos de formato]]
[[fr:Codes de mise en forme]]
[[it:Codici di formattazione]]
[[pl:Formatowanie tekstu]]
[[pt:Códigos de formatação]]
[[ru:Форматирование текста]]
[[zh:格式化代码]]