# BasModScripts

**Repository Path**: ben-yin/bas-mod-scripts

## Basic Information

- **Project Name**: BasModScripts
- **Description**: 剑与魔法VR MOD脚本
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-11-05
- **Last Updated**: 2025-11-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Mod, vr, Unity

## README

# CultivationSkills Mod for Blade & Sorcery

一个为 VR 游戏《Blade & Sorcery》开发的修仙风格技能模组，包含多种独特的战斗技能和法术。

## 功能特性

### 1. 飞剑术 (Sword Blink)
允许玩家在投掷武器后瞬移到武器位置，实现快速移动和攻击。
- 投掷武器时按住握持键可瞬移至武器位置
- 可配置开关和相关参数
- 配合飞行技能使用效果更佳

### 2. 御剑飞行 (Fly By Sword)
使用握持的武器作为推进器在空中飞行。
- 按住副手键启动飞行模式
- 可调节飞行速度
- 支持面向方向或武器方向飞行

### 3. 精准投掷 (Precise Throw)
自动引导投掷物追踪敌人。
- 投掷时自动锁定目标
- 可调节追踪力度
- 支持面部或武器方向检测

### 4. 万剑诀 (Thousand Swords Technique)
强大的法术技能，可同时发射多把飞剑攻击敌人。
- 长按施法积累能量
- 发射数量随充能时间增加
- 智能追踪多个目标
- 可调节发射力度和飞剑存在时间

## 安装说明

1. 确保已安装 Blade & Sorcery 游戏
2. 将编译后的 DLL 文件放入游戏的 Mods 文件夹
3. 将 JSON 配置文件放入相应的游戏数据目录
4. 启动游戏，在技能树中解锁相关技能

## 编译要求

- .NET Framework 4.7.2
- 引用游戏核心库文件 (ThunderRoad.dll 等)
- Visual Studio 或其他支持 C# 的 IDE

## 项目结构

```
CultivationSkills/
├── Skills/                 # 核心技能实现
│   ├── SkillFlyBySword.cs          # 御剑飞行技能
│   ├── SkillPreciseThrow.cs        # 精准投掷技能
│   ├── SkillSwordBlink.cs          # 飞剑术技能
│   ├── SpellThousandSwordsTechnique.cs  # 万剑诀法术
│   └── IMySkill.cs                 # 技能接口
├── Utils/                  # 工具类
│   ├── GameUtils.cs                # 游戏通用工具函数
│   ├── MyAssets.cs                 # 资源管理
│   ├── MySkillTree.cs              # 技能树管理
│   └── SwordShoot.cs               # 飞剑发射相关功能
├── json/                   # 游戏配置文件
│   ├── Container_ThousandSwordsTechnique.json
│   ├── SkillTree_ThousandSwordsTechnique.json
│   └── 其他技能配置文件
├── ScriptsEntryPoint.cs    # 模组入口点
└── CultivationSkills.csproj # 项目文件
```

## 技能详情

### 飞剑术 (Sword Blink)
通过投掷武器后按住握持键，玩家可以瞬间移动到武器位置。这个技能特别适合快速接近敌人或跨越地形障碍。

### 御剑飞行 (Fly By Sword)
提供空中机动能力，玩家可以通过按住副手键来激活飞行模式。飞行方向可以设置为面向方向或武器指向方向。

### 精准投掷 (Precise Throw)
增强投掷武器的准确性，自动引导武器飞向检测到的敌人，提高命中率。

### 万剑诀 (Thousand Swords Technique)
强大的范围攻击法术，可以同时发射多把飞剑攻击敌人。充能时间越长，发射的飞剑数量越多。

## 配置选项

模组提供多种可配置选项，包括：
- 飞行速度
- 投掷力度
- 飞剑存在时间
- 射击数量上限
- 检测角度和距离

这些选项可以在游戏中通过模组配置菜单进行调整。

## 开发说明

该项目遵循 Blade & Sorcery 的模组开发规范，使用 ThunderScript 框架进行开发。

主要类说明：
- `ScriptsEntryPoint`: 模组入口点，负责初始化和清理资源
- `MySkillTree`: 技能管理器，统一管理所有技能的加载和卸载
- `GameUtils`: 提供通用的游戏功能函数
- `MyAssets`: 负责音频等资源的加载和管理
- `SwordShoot`: 处理飞剑的生成和发射逻辑

## 许可证

本项目为 Blade & Sorcery 游戏模组，仅供个人使用和学习参考。请遵守游戏的使用条款和相关法律法规。