カードセット・カスタマイズ・チュートリアル

カードセットのセットアップ

カードセットを作成する最も簡単な方法は、cardsetsディレクトリにある同じタイプの既存のカードセットフォルダをコピーすることです。すべてのカードセットを動作させるには、いくつかのファイルが必要です。

各カードの画像 - これらの画像は、config.txtファイル（後述）で定義されているものと同じ形式およびサイズである必要があります。ファイル名は、スペードのエースであれば 01s.png のように命名してください。最初の2桁（またはそれ以上）がランクを、その後の文字がスートを表します。フレンチデッキやフレンチスートを使用するデッキ（Hex AやTarockデッキなど）では、スートは hcds と表記され、その他のデッキではアルファベット順にラベル付けされます。ジョーカーや切り札にはスート文字 z が使用されます。
シェードファイル - 例：shade.png
少なくとも1つの背面画像（後述のconfig.txtファイルで定義）
config.txtファイル（形式は後述）
著作権情報を記載したコピーライトファイル

以下のオプションファイルを追加することもできますが、これらは特定の状況下でのみ使用されます。

ボトム画像。スタックの底面に使用される複数の画像です。PySolのインストール環境がスタック底面の生成をサポートしていない場合、または手動で有効にした場合（現在はoptions.cfgファイルの編集でのみ可能）にのみ使用されます。使用されるボトムはカードセットのタイプによって異なります。各ボトムにはサフィックス -n が付いたバージョンがあり、適切なオプションが有効な場合にネガティブボトムとして使用されます。
シャドウ画像。PySolのインストール環境が自動生成シャドウをサポートしていない場合にのみ使用されます。

config.txt テンプレート

PySolFC solitaire cardset;$A;$FMT;$B;$C;$D,$E;$F;$G;$H
<internal_name>;<cardset_name>
X Y D
XOFF YOFF SXOFF SYOFF
back01.ext
back01.ext;back02.ext;back03.ext

1行目

$A: カードセットのバージョン番号。1行目の ";" で区切られたフィールドの数に対応します（例：.gif;1;78;8,1016 → $A=4)

(警告: Mahjonggの場合、$Aは常に6または7である必要があり、行に$Fフィールドを含める必要があります。ただし、必要に応じて$Fに0を入れても構いません。)

(注意: $Dと$Eはカンマで区切られており、1つのフィールドとしてカウントされます)

$FMT: 使用する画像の形式 - .gif, .png, .jpg, .ppm, .bmp がサポートされています

$B: カードセットのタイプ（以下のタイプを参照）

カードセット・タイプ:

French = 1
Hanafuda = 2
Tarock = 3
Mahjongg = 4
Hex A Deck = 5
Mughal Ganjifa = 6
Navagraha Ganjiga = 7
Dashavatara Ganjifa = 8
Trumps Only = 9
Matching = 10
Puzzle = 11
Ishido = 12

$C: カードセットに含まれるカードの数。一般的に 42, 48, 52, 68, 78, 96 または 120

$D: カードセットのスタイル（このフィールドには、カンマで区切られた1つ以上の値を保持できます）

カードセット・スタイル:

Abstract = 35
Adult = 1
Animals = 2
Anime = 3
Art = 4
Cartoons = 5
Children = 6
Classic Look = 7
Collectors = 8
Computers = 9
Divination = 36
Engines = 10
Fantasy = 11
Four Color = 37
Ganjifa= 30
Hanafuda = 12
Hex A Deck = 29
Holiday = 13
Ishido = 34
Mahjongg = 28
Matching = 32
Monochrome = 38
Movies = 14
Matrix = 31
Music = 15
Nature = 16
Operating Systems = 17
People = 19
Places = 20
Plain = 21
Products = 22
Puzzle = 33
Round Cardsets = 18
Science Fiction = 23
Sports = 24
Tarock = 27
Vehicles = 25
Video Games = 26

$E: カードセットの原産国

カードセット原産国:

Australia = 1021
Austria = 1001
Belgium = 1019
Canada = 1010
China = 1011
Czech Republic = 1012
Denmark = 1013
England = 1003
France = 1004
Germany = 1006
Great Britain = 1014
Hungary = 1015
India = 1020
Italy = 1005
Japan = 1016
Netherlands = 1002
Portugal = 1022
Russia = 1007
Spain = 1008
Sweden = 1017
Switzerland = 1009
USA = 1018

$F: カードセットが作成された年（1000年から2299年の範囲）

$G: カードセットのサブタイプ。通常は 0。フレンチタイプのカードセットでジョーカーがある場合は 1 を使用します。Puzzleタイプのカードセットの場合は、1行/列あたりのピース数になります。

$H: 3D Mahjonggカードセットかどうか - そうであれば 1、そうでなければ 0。バージョン7未満のカードセットの場合、バージョン6のカードセットはこの値を 1 として扱い、それより古いバージョンのカードセットは 0 として扱います。

2行目

<internal_name>: PySolFCがカードセットを識別するための名前（スペースなし）

(ヒント: 数字の接頭辞を追加することもできます（例：123-cardset-name）)

<cardset_name>: カードセットマネージャーに表示されるカードセット名。50文字を超える名前は切り捨てられるので注意してください。

3行目

X: カードの幅（カード画像の幅）
Y: カードの高さ（カード画像の高さ）
D: 色深度（ほとんどの場合 8）

4行目

XOFF: カードの水平オフセット
YOFF: カードの垂直オフセット
SXOFF: 水平シャドウのオフセット（ほとんどの場合 7）
SYOFF: 垂直シャドウのオフセット（ほとんどの場合 7）

5行目

back01.ext: デフォルトの背面画像の名前（extはファイル拡張子を意味します。例：pngやgif）

6行目

back01.ext;back02.ext;back03.ext;…`: デフォルトのものを含む、その他の背面画像の名前。

このドキュメントについて:

注意: このチュートリアルは不完全な場合があります。プレイヤーが独自のカードセットをカスタマイズするのを助けるために、いかなる保証もなく現状のまま提供されています。提案がある場合は、作者のメールアドレス、PySol FCのGitHub issueトラッカー、またはPySol FCのSourceforge issueトラッカーまでお送りください。

注意 2: config.txtと同じディレクトリに、Info/Settingsからアクセスできるテキストを含むCOPYRIGHTという名前のファイルを配置してください。

ライセンス:

このチュートリアルは、GNU General Public Licenseバージョン3以降の条件の下で作成されました。そのまま再配布したり、改変したりすることが可能です。

Shlomi Fishは、本ドキュメントへの改変部分をCC0/パブリックドメイン/MITライセンス/GPL条件の下に提供します。

クレジット:

謝辞:

Andreas Sauer（いくつかの点の明確化）
Shlomi Fish（本チュートリアルの改善）

インデックスに戻る

PySolFC Documentation - version 3.7.0