# TPチケットシステム導入手順
## ファイル構成
```
resources/[local]/tp-ticket/
├── fxmanifest.lua
├── config.lua
├── client.lua
└── server.lua
```
## 導入手順
### 1. ファイル設置
上記のファイル構成で、各ファイルを作成・配置してください。
### 2. ox_inventoryへのアイテム追加
`ox_inventory/data/items.lua` に以下のアイテムを追加：
```lua
['tp_ticket'] = {
label = 'TPチケット',
weight = 1,
stack = true,
close = true,
description = 'このチケットを使用して指定の場所にテレポートできます',
client = {
image = 'tp_ticket.png',
usetime = 2500,
}
},
```
### 3. アイテム画像の追加（オプション）
`ox_inventory/web/images/` フォルダに `tp_ticket.png` 画像ファイルを配置してください。
### 4. server.cfg への追加
```cfg
ensure tp-ticket
```
## 使用方法
### プレイヤー側
1. TPチケットを入手
2. インベントリでTPチケットを右クリック→使用
3. 表示されるメニューからテレポート先を選択
### 管理者側
- `/giveticket [プレイヤーID] [数量]` - TPチケットを付与
## 設定のカスタマイズ
### テレポート場所の追加・変更
`config.lua` の `Config.TPLocations` を編集：
```lua
Config.TPLocations = {
新しい場所 = {
coords = vector4(x, y, z, heading),
location = '場所ID',
label = '表示名',
},
}
```
### アイテム名の変更
`config.lua` の `Config.TPTicketItem` を変更し、ox_inventoryのitems.luaも合わせて変更してください。
## 機能
- **セキュア**: サーバーサイドでチケットの所持確認
- **使いやすい**: ox_libのコンテキストメニューでシンプルな操作
- **拡張可能**: configで簡単に場所の追加・変更が可能
- **ログ機能**: サーバーコンソールにテレポート履歴を記録
- **エラーハンドリング**: 適切な通知とエラー処理
## 必要な依存関係
- qb-core
- ox_inventory
- ox_lib
- oxmysql（自動で含まれます）