Skip to content
This repository has been archived by the owner on May 11, 2024. It is now read-only.

This is a plugin for Virtools, which mainly serves Ballance mapping and other Ballance development.

License

Notifications You must be signed in to change notification settings

yyc12345/BallanceVirtoolsHelper

Repository files navigation

Ballance Virtools Helper

中文版本

Brief introduction

This is a plugin for Virtools, which mainly serves Ballance mapping and other Ballance development.
Currently only contains the basic functions, the rest more useful functions will be developed in future versions.

Technical information

The BM file standard used can be found in here(Chinese only).
The tools chain standard used and the format of the files in the BMMeshes folder can be found in here(Chinese only).
Only supports Virtools 3.5

Functions introduction

Ballance Mapping

BM

  • Import BM file: Import BM file. It should be noted that in order to ensure compatibility, the import operation will forcibly separate each vertices. The result of this operation is that the number of vertices will always be three times the number of faces, and each connected vertices will be Repeat, so the mesh size will increase.

  • Export BM file: Export BM file, you can choose to export by object, group, and all. It should be noted that when exporting all, a Virtools default 3D object will also be exported, but it only needs to be deleted when importing again.

  • Fix texture: This is a texture restoration in a broad sense, not just limited to the materials exported from Blender. This menu will repair material errors according to the texture file referenced by the material. This function is only to repair the error caused by the incomplete implementation of the early BM file import and export function. The BM import and export function is now complete. Using the latest version of the import and export tool, most materials do not need this option to repair.

Group

  • Auto grouping: automatic grouping, the grouping principle is based on the tools chain standard.
  • Grouping detector: Grouping detector, incomplete.

Add Shadow

Add shadow attributes to all objects in the Shadow group.

Ballance Script

CKDataArray

  • Export to csv: Export the data in the specified table into csv format, by calling WriteElements.
  • Import to csv: Import csv data into the specified table, by calling LoadElements.
  • Clean all data: clear the data of the specified table.

Ballance Misc

Export as special NMO

Save the current document in NMO format with IC.

Convert encoding

Convert the encoding which used in current document's multi-byte text. Used for garbled repair.

Plugin settings

  • External texture folder: Please fill in the Texture directory of Ballance, the plug-in will call the external texture file from this directory (the texture file originally with Ballance).
  • No component group name: Objects in this group will be forced to be set as non-Component. If left blank, this function is not needed.
  • Omitted material prefix: The name prefix of material which will be processed in Fix texture. This options may be useful for keeping some special materials configurated by yourself.

Compile and debug

SDK

  • zlib:Please fetch the latest version, then compile zlibvc project with ReleaseWithoutAsm mode via the project file located in contrib\vstudio\vc14. You may need to change some compile parameters if you use other compilers or project files.
  • Virtools 3.5 SDK:We suggest to install full Virtools Dev 3.5 environment if you want to do some debugging.

Compile

First, you need open BallanceVirtoolsHelper.props(via text editor or Visual Studio). Then you need to change all macro within this file and point them to correct folder(without slash).

  • VIRTOOLS35_PATH:Point to Virtools install path. You should find devr.exe in this folder.
  • ZLIB_PATH:Point to yout fetched zlib project.

Now, you can pick a proper project configuration to compile this plugin. At the same time, you should copy your built zlibwapi.dll to Virtools root path.
In addition, the files that need to be deployed in the BMMeshes folder under the Virtools root directory are shared with another project of mine, which can be found in here found. You need to copy it manually.

Install

Manually compile the project and install it. But this is not recommended, because the current latest commit may contain many bugs.

The recommended method is to find the latest stable version from the Release on the GitHub page and unzip it directly to the root directory of Virtools after downloading. If the same name or folder coverage appears, click Allow.

About

This is a plugin for Virtools, which mainly serves Ballance mapping and other Ballance development.

Topics

Resources

License

Stars

Watchers

Forks