Minecraft サーバに Timeless and Classics Zero Guns (TaCZ) をインストールする方法

• 概要
• 環境
• サーバ側
  • compose.yaml
  • TaCZ のダウンロードとインストール
  • 起動確認
• クライアント側 (Mac)
  • forge のインストール
  • TaCZ のダウンロードとインストール
  • 起動確認
• クライアント側 (Windows)
  • JDK のインストール
  • forge のインストール
  • TaCZ のダウンロードとインストール
  • 起動確認
• 最後に

概要

サーバにインストールしクライアント側にも同じ Mod のインストールが必要です
必ずバージョンは揃えましょう

環境

• サーバ側
  • macOS 26.4.1
  • Minecraft 1.20.1
  • forge 47.4.10
  • TaCZ 1.1.8
• クライアント側
  • macOS 26.4.1/Windows11Home
  • Minecraft 1.20.1
  • forge 47.4.10
  • TaCZ 1.1.8

サーバ側

compose.yaml

サーバ側は docker compose で起動します

• vim compose.yaml

services:
  mc:
    image: itzg/minecraft-server
    tty: true
    stdin_open: true
    ports:
      - "25565:25565"
    environment:
      EULA: "TRUE"
      MODE: "creative"
      VERSION: "1.21.11"
    volumes:
      # attach the relative directory 'data' to the container's /data path
      - ./data:/data

  mc_mod:
    image: itzg/minecraft-server
    tty: true
    stdin_open: true
    ports:
      - "25566:25565"
    environment:
      EULA: "TRUE"
      MODE: "creative"
      VERSION: "1.20.1"
      TYPE: "forge"
    volumes:
      # modded world/data directory for the modded server
      - ./modded-data:/data
      # put the CurseForge mod JAR into this local directory
      - ./timeless_and_classics_zero/mods:/data/mods
      # optional config directory for mod/server configs
      - ./timeless_and_classics_zero/config:/data/config

通常のマイクラサーバとは別で TaCZ がインストールされた forge サーバを起動します

TaCZ のダウンロードとインストール

https://www.curseforge.com/minecraft/mc-mods/timeless-and-classics-zero

から tacz-1.20.1-1.1.8-release.jar をダウンロードします
サーバ側は timeless_and_classics_zero/mods 配下に配置します

• mkdir timeless_and_classics_zero/mods
• mkdir timeless_and_classics_zero/config
• mkdir modded-data

起動確認

• docker compose up -d

で問題なく起動することを確認します

クライアント側 (Mac)

forge のインストール

https://files.minecraftforge.net/net/minecraftforge/forge/index_1.20.1.html

から forge-1.20.1-47.4.10-installer.jar をダウンロードしダブルクリックでインストールします
デフォルトだと開けないのでプライバシーとセキュリティから jar を開きます

TaCZ のダウンロードとインストール

https://www.curseforge.com/minecraft/mc-mods/timeless-and-classics-zero

から tacz-1.20.1-1.1.8-release.jar をダウンロードします
Mac の場合のクライアントは以下のパスに Mod を配置します

/Users/username/Library/Application Support/minecraft/mods

起動確認

ランチャーを起動し1.20.1-forge-47.4.10 の起動構成を作成してその起動構成からマイクラを起動しましょう

あとはマルチプレイから起動した docker compose のサーバにアクセスすれば OK です

クライアント側 (Windows)

JDK のインストール

Oracle 版でも OpenJDK でも OK です

https://www.oracle.com/jp/java/technologies/downloads/

コマンドをプロンプトを起動して java コマンドで実行できるか確認します

forge のインストール

https://files.minecraftforge.net/net/minecraftforge/forge/index_1.20.1.html

から forge-1.20.1-47.4.10-installer.jar をダウンロードします
ダブルクリックだとインストールできないのでコマンドプロンプトを開いて起動します

• java -jar forge-1.20.1-47.4.10-installer.jar

TaCZ のダウンロードとインストール

https://www.curseforge.com/minecraft/mc-mods/timeless-and-classics-zero

から tacz-1.20.1-1.1.8-release.jar をダウンロードします
Windows の場合のクライアントは以下のパスに Mod を配置します

C:\Users\xxx\AppData\Roaming\.minecraft\mods

起動確認

ランチャーを起動し1.20.1-forge-47.4.10 の起動構成を作成してその起動構成からマイクラを起動しましょう

あとはマルチプレイから起動した docker compose のサーバにアクセスすれば OK です

最後に

マルチで Mod を使って遊ぶ場合にはサーバ側とクライアント側に同じバージョンの同じ Mod をインストールする必要があるので注意しましょう

kabuステーションAPIを使って株を売買するPythonスクリプト

• 概要
• 環境
• 株を購入する Python スクリプト
• 売りの場合
• ログ格納場所
• API リファレンス
• トラブルシューティング
• 最後に
• 参考サイト

概要

前回 kabuステーションAPIを使用して現在のポジションを取得しました
今回は株を売買する方法を紹介します

環境

• M2 Pro Mac mini
• macOS 26.4.1
• UTM 4.7.5
  • Windows11 Home
• kabuステーション 5.40.0.0
• nginx 1.30.0
• Python 3.12.13

株を購入する Python スクリプト

• vim buy_stock.py

import time

import requests

# =========================
# 設定
# =========================
API_PASSWORD = "xxx"  # kabuステーションで設定したAPIパスワード
BASE_URL = "http://192.168.65.9:28081/kabusapi"  # 検証環境

SYMBOL = "1306"  # TOPIX ETF
EXCHANGE = 1  # 東証
QTY = 10  # 最小単位（検証なので10でOK）


# =========================
# トークン取得
# =========================
def get_token():
    url = f"{BASE_URL}/token"
    res = requests.post(url, json={"APIPassword": API_PASSWORD})

    if res.status_code != 200:
        print("トークン取得エラー:", res.text)
        return None

    return res.json()["Token"]


# =========================
# 共通ヘッダ
# =========================
def headers(token):
    return {"X-API-KEY": token}


# =========================
# 成行買い
# =========================
def buy_market(token):
    url = f"{BASE_URL}/sendorder"

    body = {
        "Symbol": SYMBOL,  # 銘柄コード
        "Exchange": EXCHANGE,  # 市場コード
        "SecurityType": 1,  # 商品種別 (1: 株式)
        "Side": 2,  # 売買区分 (2: 買)
        "CashMargin": 1,  # 信用区分 (1: 現物)
        "DelivType": 2,  # 受渡区分 (2: 預り金)
        "FundType": "02",  # 資産区分 (02: 保護)
        "AccountType": 4,  # 口座種別 (4: 特定)
        "Qty": QTY,  # 注文数量
        "FrontOrderType": 10,  # 執行条件 (10: 成行)
        "Price": 0,  # 注文価格
        "ExpireDay": 0,  # 注文有効期限 (0: 本日)
    }

    res = requests.post(url, json=body, headers=headers(token))

    if res.status_code != 200:
        print("注文エラー:", res.status_code, res.text)
        return False

    print("注文成功:", res.json())
    return True


# =========================
# ポジション取得
# =========================
def get_positions(token):
    url = f"{BASE_URL}/positions"
    res = requests.get(url, headers=headers(token))

    if res.status_code != 200:
        print("ポジション取得エラー:", res.text)
        return None

    return res.json()


# =========================
# メイン
# =========================
def main():
    token = get_token()
    if not token:
        return

    # ① 買う
    if not buy_market(token):
        return

    # 約定待ち（重要）
    print("約定待ち...")
    time.sleep(3)

    # ② ポジション取得
    positions = get_positions(token)

    print("=== 保有ポジション ===")
    if not positions:
        print("ポジションなし")
        return

    for p in positions:
        print(f"""
銘柄: {p.get('Symbol')}
数量: {p.get('LeavesQty')}
取得単価: {p.get('Price')}
現在値: {p.get('CurrentPrice')}
評価損益: {p.get('ProfitLoss')}
        """)


# =========================
if __name__ == "__main__":
    main()

売りの場合

上記のスクリプトで

• Side -> 1
• FundType -> " " (半角スペース2つ)

にすれば売りもできます

ログ格納場所

%appdata%\KabuS\Log

API リファレンス

https://kabucom.github.io/kabusapi/reference/index.html#operation/sendorderPost

body の各種パラメータはこちらを参照してください

あとは Github の Issue にいろいろ情報があります

https://github.com/kabucom/kabusapi/issues/

トラブルシューティング

注文エラー: 400 {"Code":1002,"Message":"数量は単位株数の倍数で入力してください"}

QTY = 10 以上にしましょう

注文エラー: 400 {"Code":4001005,"Message":"パラメータ変換エラー - 詳細はkabuSログファイルを確認してください"}

余計なパラメータがあったり不足しているパラメータがあるとこれが頻発します
自分は FundType が足りていませんでした

最後に

どうやら検証環境の場合は実際に購入することはできないようです
とりあえず以下のようになれば注文のリクエストは成功しています

注文成功: {'Result': 0, 'OrderId': None}

あとは各種パラーメタを調整すれば好きな銘柄の売買ができます

参考サイト

• https://github.com/kabucom/kabusapi/issues/11

kabuステーションAPIを使って現在のポジション一覧を取得するPythonスクリプト

• 概要
• 環境
• ポジションの一覧を取得する Python スクリプト
• 最後に

概要

前回 kabuステーションAPIを使用して認証トークンを取得しました
今回はポジションの一覧を取得します

環境

• M2 Pro Mac mini
• macOS 26.4.1
• UTM 4.7.5
  • Windows11 Home
• kabuステーション 5.40.0.0
• nginx 1.30.0
• Python 3.12.13

ポジションの一覧を取得する Python スクリプト

• vim list_positions.py

import requests

# =========================
# 設定
# =========================
API_PASSWORD = "xxx"  # kabuステーションで設定したAPIパスワード
BASE_URL = "http://192.168.65.9:28081/kabusapi"  # 検証環境


# =========================
# トークン取得
# =========================
def get_token():
    url = f"{BASE_URL}/token"

    body = {"APIPassword": API_PASSWORD}

    res = requests.post(url, json=body)

    if res.status_code != 200:
        print("トークン取得エラー:", res.status_code, res.text)
        return None

    return res.json().get("Token")


# =========================
# ポジション取得
# =========================
def get_positions(token):
    url = f"{BASE_URL}/positions"

    headers = {"X-API-KEY": token}

    res = requests.get(url, headers=headers)

    # トークン期限切れ対応
    if res.status_code == 401:
        print("トークン期限切れ → 再取得")
        token = get_token()
        if not token:
            return None

        headers["X-API-KEY"] = token
        res = requests.get(url, headers=headers)

    if res.status_code != 200:
        print("ポジション取得エラー:", res.status_code, res.text)
        return None

    return res.json()


# =========================
# メイン処理
# =========================
def main():
    token = get_token()

    if not token:
        print("トークン取得失敗")
        return

    positions = get_positions(token)

    if not positions:
        print("ポジションなし or 取得失敗")
        return

    print("=== 保有ポジション ===")
    for p in positions:
        print(f"""
銘柄: {p.get('Symbol')}
数量: {p.get('LeavesQty')}
取得単価: {p.get('Price')}
現在値: {p.get('CurrentPrice')}
評価損益: {p.get('ProfitLoss')}
        """)


# =========================
if __name__ == "__main__":
    main()

• uv run python list_positions.py

最後に

次回は実際に売買する方法を紹介します

kabuステーションAPIをコールして認証トークンを取得する

• 概要
• 環境
• Windows 上に nginx を構築
• トークン取得用スクリプト
• 最後に
• 参考サイト

概要

前回 kabuステーションをWindowsのVM上に構築しました
今回は実際に API をコールしトークンを取得します

環境

• M2 Pro Mac mini
• macOS 26.4.1
• UTM 4.7.5
  • Windows11 Home
• kabuステーション 5.40.0.0
• nginx 1.30.0
• Python 3.12.13

Windows 上に nginx を構築

Python スクリプトを Mac 上からコールするので kabuステーションが外部からアクセスできるように nginx を構築します

Windows 上で直接 Python スクリプトを実行してもいいですがいろいろとハマるので Mac 上から実行します

• nginx for windows のダウンロードとインストール https://nginx.org/en/download.html
• nginx.conf の修正
• nginx.exe の実行

worker_processes  1;
events {
    worker_connections  1024;
}
http {
    include       mime.types;
    default_type  application/octet-stream;
    sendfile        on;
    keepalive_timeout  65;

    map $http_upgrade $connection_upgrade { 
    default upgrade;
    ''      close;
    } 

    server {
        listen       28081;
        server_name  localhost;

        proxy_http_version 1.1;
        proxy_set_header Host localhost;
        proxy_set_header Upgrade $http_upgrade; 
        proxy_set_header Connection $connection_upgrade;

        location / {
            proxy_pass   http://127.0.0.1:18081/;
        }
    }
}

28081 ポートでアクセスできるようにします
本番の場合は 18080 に proxy します

とりあえずテストなのでバイナリを直接ダブルクリックで実行すれば OK です
起動できているかは localhost:28081/kabusapi にアクセスしてみましょう
停止する場合はタスクマネージャーを使って nginx.exe プロセスを停止します

トークン取得用スクリプト

Windows 上で直接作成しても OK ですし Mac 側で編集/作成して VM 側に共有しても OK です

requests が必要なのでインストールしておきましょう

• vim fetch_token.py

import requests

# =========================
# 設定
# =========================
API_PASSWORD = "xxx"  # kabuステーションで設定したAPIパスワード
BASE_URL = "http://192.168.65.9:28081/kabusapi"  # 検証環境


# =========================
# トークン取得
# =========================
def get_token():
    url = f"{BASE_URL}/token"

    body = {"APIPassword": API_PASSWORD}

    res = requests.post(url, json=body)

    if res.status_code != 200:
        print("ERROR:", res.status_code, res.text)
        return None

    data = res.json()
    return data.get("Token")


if __name__ == "__main__":
    token = get_token()

    if token:
        print("取得成功:")
        print(token)
    else:
        print("トークン取得失敗")

• uv run python fetch_token.py

これでトークンが表示されれば OK です
API_PASSWORD は前回 API を有効にした際に設定したパスワードを入力しましょう

最後に

kabu ステーション API を使って API をコールするための認証トークンを取得してみました
kabu ステーション API は Windows 上に構築しスクリプトは Mac や Linux 上からコールするようにしましょう
今回はとりあえずバイナリを直接実行していますが本格的に取引を行う場合は自動起動やプロセス監視/ログ監視が必要になると思います

次回は API を使ってポジションの一覧を取得する方法を紹介します

参考サイト

• https://github.com/kabucom/kabusapi/issues/34

Mac に kabuステーションAPI環境を構築する

• 概要
• 環境
• UTM/CrystalFetch インストール
• CrystalFetch で Windows11 の ISO イメージ取得
• UTM で Windows11 の VM 作成
• kabuステーションのダウンロードとインストール
• 三菱UFJ eスマート証券のアカウントでログイン
• kabuステーションの設定からAPIを有効化
• 動作確認
• 最後に

概要

まずは構築しAPIを有効にします

環境

• M2 Pro Mac mini
• macOS 26.4.1
• UTM 4.7.5
  • Windows11 Home
• kabuステーション 5.40.0.0

UTM/CrystalFetch インストール

公式サイトからダウンロードしインストールします

CrystalFetch で Windows11 の ISO イメージ取得

AppleSillicon 上で動作させるのでチェックをオンにします

UTM で Windows11 の VM 作成

• ライセンスキーがあれば入れる
• 各種 Windows のセットアップ
• display output is not active に注意
  • インストール時は「virtio-ramfb-gl (GPU Supported)」 Retinaオン
  • Windowsインストール後は「virtio-grpu-gl-pci (GPU Supported)」Retinaオフ
• 全画面時の解除はCtrl+Altでマウスのフォーカスを外す

kabuステーションのダウンロードとインストール

https://download.r30.kabu.co.jp/ap/kabustation/ から exe をダウンロードしインストールします

三菱UFJ eスマート証券のアカウントでログイン

口座番号とパスワードでログインします

kabuステーションの設定からAPIを有効化

• 右上の「歯車」
• 「システム設定」
• API タブ
• 「APIを利用する」にチェック
• APIパスワードを両方入力
• kabuステーションを再起動し右上のAPIマークが有効になっていることを確認

動作確認

ブラウザで http://localhost:18081/kabusapi にアクセスしリクエスト不正になることを確認します

最後に

次回は API をコールするためのトークンを取得します

pipenv から uv に移行する

• 概要
• 環境
• 流れ
• python 準備
• uv インストール
• pyproject.toml の作成
• uv sync
• Dockerfile 修正
• README 修正
• .dockerignore 修正
• compose.yaml 修正
• 各種シェルスクリプトの修正
• Github Actions 修正
• vscode の設定の修正
• .env ファイルを使っている場合の注意事項
• 移行後
• 最後に

概要

自分のプロジェクトを pipenv から uv に置き換えたので手順を紹介します

環境

• macOS 26.3.1
• Python 3.12.13
• uv 0.11.7

流れ

1. pyproject.toml の作成
2. Dockerfile の修正

python 準備

• cat .python-version

3.12.13

uv インストール

• pip install uv

pyproject.toml の作成

[project]
name = "ai-gallery"
version = "0.1.0"
description = "AI Gallery application"
requires-python = ">=3.12"
dependencies = [
    "flask",
    "google-cloud-storage",
    "redis",
    "gunicorn",
    "google-genai",
    "pillow",
    "py-vapid",
    "pywebpush",
]

[dependency-groups]
dev = [
    "black",
    "isort",
    "pyright",
    "pytest",
    "bandit",
]

[tool.black]
line-length = 88
target-version = ["py312"]

[tool.isort]
profile = "black"
line_length = 88

[tool.pyright]
pythonVersion = "3.12"

uv sync

• uv sync

これで uv.lock が作成されます
仮想環境のパスはプロジェクト直下の .venv に作成されます

Dockerfile 修正

pipenv -> uv に変更します

diff --git a/Dockerfile b/Dockerfile
index 499f280..4ec6df7 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -1,12 +1,16 @@
 FROM python:3.12.13-alpine3.23
 
-COPY . /home
 WORKDIR /home
 
-RUN pip install pipenv
-RUN pipenv install
+COPY pyproject.toml uv.lock ./
+
+RUN --mount=type=cache,target=/root/.cache/pip \
+    pip install uv && \
+    uv export --no-dev | pip install --no-cache-dir -r /dev/stdin
+
+COPY . .
 
 ENV WAIT=on
 ENV MODE=1
 
-CMD ["pipenv", "run", "python", "app.py"]
+CMD ["python", "app.py"]

今回は system 環境にインストールするようにしています

uv sync でも以下のような流れで動作するのでこの当たりは好きなように修正してください

RUN --mount=type=cache,target=/root/.cache/pip \
    pip install uv && \
    uv sync --frozen --no-install-project --no-dev
CMD ["uv", "run", "--no-sync", "gunicorn", "-w", "1", "-b", "0.0.0.0:8080", "app:app"]

--no-sync オプションは実行時に uv sync を実行しないための設定です

一応 docker build -> run して動作確認しておくといいでしょう

README 修正

pipenv で実行している部分を uv に書き換えます
例えば以下のような部分を書き換えていきます

-- pipenv install -d
+- uv sync --all-groups

-- pipenv run isort . && pipenv run black . && pipenv run pyright . && npm run format
+- uv run isort . && uv run black . && uv run pyright . && npm run format

-- pipenv run pytest test/ && pipenv run bandit -r . && REDIS_PASSWORD="" pipenv run gunicorn -w 1 -b 0.0.0.0:8080 app:app
+- uv run pytest test/ && uv run bandit -r . && REDIS_PASSWORD="" uv run gunicorn -w 1 -b 0.0.0.0:8080 app:app

-- pipenv requirements > requirements.txt
+- uv export > requirements.txt

.dockerignore 修正

node_modules/
.venv/

compose.yaml 修正

pipenv -> uv のコマンド修正をします

command: pipenv run python check_new_message.py

↓

command: uv run python check_new_message.py

各種シェルスクリプトの修正

あれば修正します
同様に pipenv -> uv で OK です

Github Actions 修正

各種 yaml ファイルを修正しましょう

diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index 50d8f31..48e8a98 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -16,11 +16,11 @@ jobs:
         uses: actions/setup-python@v5
       - name: Install dependencies
         run: |
-          python -m pip install --upgrade pipenv
-          pipenv install -d
+          python -m pip install --upgrade uv
+          uv sync --all-groups
       - name: Lint with isort
         run: |
-          pipenv run isort --check --diff .
+          uv run isort --check --diff .
       - name: Lint with black
         run: |
-          pipenv run black --check .
+          uv run black --check .

実際にアクションを実行して動作確認しましょう

vscode の設定の修正

• .vscode/settings.json

diff --git a/.vscode/settings.json b/.vscode/settings.json
index 8a2fea7..1bd2c9b 100644
--- a/.vscode/settings.json
+++ b/.vscode/settings.json
@@ -1,4 +1,3 @@
 {
-  "python-envs.defaultEnvManager": "ms-python.python:pipenv",
   "python-envs.pythonProjects": []
 }

これでプロジェクト配下にある .venv を自動で読み込んでくれます

.env ファイルを使っている場合の注意事項

• uv run --env-file .env

のように命じ的に指定しないと読み込んでくれないので注意しましょう

移行後

• Pipfile と Pipfile.lock の削除
• .isort.cfg の削除
• pip uninstall pipenv
• venv の削除
  • rm -rf ~/.local/share/virtualenvs/ai-gallery-nT0ArqSL
• pipenv コマンドがプロジェクト内で使われていないか確認
  • git grep 'pipenv'
• GAE などにもデプロイしている場合は動作確認

uv export > requirements.txt
gcloud app deploy -q

最後に

アプリ自体を修正するのは簡単ですが CI や各種スクリプトで使われているコマンドを書き換えるのが面倒かなという印象です

Dockerfile の RUN では --mount を使おう

• 概要
• 環境
• 前
• 後
• 最後に

概要

ビルドを高速化しましょう

環境

• macOS 26.3.1
• docker 29.3.1

前

FROM python:3.12.11-alpine3.21

# 必要なパッケージをインストール
RUN apk add --no-cache nodejs npm

COPY . /home
WORKDIR /home

RUN pip install pipenv
RUN pipenv install

ENV REDIS_HOST=redis

# ミニファイ用ツールをインストール
RUN npm install -g clean-css-cli uglify-js

# CSS / JS をミニファイ
RUN uglifyjs static/js/fontawesome-all.min.js -o static/js/fontawesome-all.min.js
RUN cleancss -o static/css/footer.css static/css/footer.css

CMD ["pipenv", "run", "gunicorn", "-w", "1", "-b", "0.0.0.0:8080", "app:app"]

後

# syntax=docker/dockerfile:1.7

FROM python:3.12.11-alpine3.21

# 必要なパッケージ
RUN apk add --no-cache nodejs npm

WORKDIR /home

# -------------------------
# ① 依存関係だけ先にコピー（キャッシュ効かせる）
# -------------------------
COPY Pipfile Pipfile.lock ./

# pipenv + cache mount
RUN --mount=type=cache,target=/root/.cache/pip \
    pip install pipenv && \
    pipenv install --deploy --system

# -------------------------
# ② npmツール（キャッシュ効かせる）
# -------------------------
RUN --mount=type=cache,target=/root/.npm \
    npm install -g clean-css-cli uglify-js

# -------------------------
# ③ アプリ本体（最後にコピー）
# -------------------------
COPY . .

ENV REDIS_HOST=redis

# -------------------------
# ④ minify（tmpfsで高速化＆不要データ残さない）
# -------------------------
RUN --mount=type=tmpfs,target=/tmp \
    uglifyjs static/js/fontawesome-all.min.js -o static/js/fontawesome-all.min.js && \
    cleancss -o static/css/footer.css static/css/footer.css

CMD ["gunicorn", "-w", "1", "-b", "0.0.0.0:8080", "app:app"]

最後に

今回はライブラリのインストールなどに使いましたが一時的な認証情報を渡すときにも使えます