VDH
101 lines
2.9 KiB
Markdown
101 lines
2.9 KiB
Markdown
# Quick Start Guide - Skill Converter
|
|
|
|
## Fastest Way to Convert All Skills
|
|
|
|
### Step 1: Open Command Prompt
|
|
1. Press `Win + R`
|
|
2. Type `cmd` and press Enter
|
|
3. Navigate to your project folder:
|
|
```
|
|
cd E:\Projects
|
|
```
|
|
|
|
### Step 2: Run the Batch Script (EASIEST)
|
|
Double-click `convert_all_skills.bat` or run:
|
|
```
|
|
convert_all_skills.bat
|
|
```
|
|
|
|
Then choose option 1 to convert from stubs1.cpp automatically!
|
|
|
|
### Step 3: Manual Python Command (RECOMMENDED FOR DEVELOPERS)
|
|
```bash
|
|
cd E:\Projects
|
|
python convert_skills_fixed.py --stubs "E:\Projects\perfect-world-source\perfect-world-source\CElement\CElementSkill\stubs1.cpp"
|
|
```
|
|
|
|
This single command will:
|
|
- ✅ Extract all skill IDs from stubs1.cpp
|
|
- ✅ Convert all skills from C++ to C#
|
|
- ✅ Create organized SkillStubs1 folder
|
|
- ✅ Generate SkillStubs1.cs registration file
|
|
- ✅ Update skill declarations
|
|
|
|
## What You'll See
|
|
|
|
```
|
|
Converting skill 1...
|
|
[OK] Created E:\Projects\perfect-world-unity\Assets\PerfectWorld\Scripts\Skills\SkillStubs1\skill1.cs
|
|
Converting skill 2...
|
|
[OK] Created E:\Projects\perfect-world-unity\Assets\PerfectWorld\Scripts\Skills\SkillStubs1\skill2.cs
|
|
...
|
|
Found 50 skills in stubs file: 1 to 100
|
|
[OK] Generated SkillStubs1.cs
|
|
[OK] Updated SkillStubs1.cs with 50 skills
|
|
|
|
============================================================
|
|
Conversion complete!
|
|
[OK] Successfully converted: 50 skills
|
|
============================================================
|
|
```
|
|
|
|
## Common Commands Cheat Sheet
|
|
|
|
```bash
|
|
# Convert from stubs file (BEST - automatic everything)
|
|
python convert_skills_fixed.py --stubs "path\to\stubs1.cpp"
|
|
|
|
# Convert specific skills for testing
|
|
python convert_skills_fixed.py --ids 1,2,3,4,5
|
|
|
|
# Convert a range
|
|
python convert_skills_fixed.py --range 1-100
|
|
|
|
# Convert multiple ranges
|
|
python convert_skills_fixed.py --range 1-50,100-150,500-600
|
|
```
|
|
|
|
## After Conversion
|
|
|
|
1. **Open Unity** - Your project at `E:\Projects\perfect-world-unity`
|
|
2. **Check Skills folder** - `Assets/PerfectWorld/Scripts/Skills/SkillStubs1/`
|
|
3. **Verify compilation** - Unity should auto-compile with no errors
|
|
4. **Test a skill** - The converted skills are now ready to use!
|
|
|
|
## Need Help?
|
|
|
|
- See `convert_skills_HOW_TO_USE.md` for detailed documentation
|
|
- Check Python installation: `python --version` (should be 3.6+)
|
|
- Verify paths in `convert_all_skills.bat` match your setup
|
|
|
|
## Troubleshooting
|
|
|
|
**"Python not found"**
|
|
- Install Python from https://www.python.org/
|
|
- Make sure "Add Python to PATH" is checked during installation
|
|
|
|
**"File not found"**
|
|
- Check paths in the command match your folder structure
|
|
- Use quotes around paths with spaces
|
|
|
|
**"Permission denied"**
|
|
- Close Unity/Visual Studio
|
|
- Run as Administrator
|
|
|
|
## Pro Tips
|
|
|
|
✨ Use `--stubs` for batch conversion - it's the smartest option!
|
|
✨ Test with `--ids 1,2,3` before converting hundreds of skills
|
|
✨ Backup your Unity project before large conversions
|
|
✨ The tool is safe to run multiple times (overwrites old files)
|