If you have issues with the engine, first make sure to read the guide and command reference topics related to the feature you're having issues with; also check the FAQ for some frequently asked questions.
In case you're sure the engine is not working as intended, check if you're running the latest available version. Most recent patches are published on our Discord server; always use them instead of importing the package from Unity's package manager, as the latter is usually outdated. When using any of the engine extensions, download and import the latest packages: Live2D, Spine, Inventory, PlayMaker, AdventureCreator.
If upgrading didn't help, try to re-install the package by deleting
Naninovel folder from the project and re-importing it. Make sure to follow upgrade instructions specified on the release page when upgrading from on older version.
In case the above steps didn't help to resolve the issue, check the issue tracker — chances are the problem is already being worked on.
Consider joining dedicated Naninovel forum, where users help each other solve development issues, share best practices and showcase their projects. The issue you're facing could potentially be already solved by other users there; and you can always ask for help, if it's not.
While we have several video tutorials and example projects showing how to use Unity to achieve some Naninovel-specific goals, please be aware that we are not able to provide any additional guidance or direct support for Unity's built-in tools.
Unity is a standalone product with an enormous set of features; it has its own documentation, support services and vast community, which produced numerous learning materials over the engine's more than a decade lifespan. Usually, you'll be able to easily find a video tutorial, guide or forum thread for any question or issue you may have; and in the rare cases it's not available, you can always ask on the Unity forum, Q&A service or use one of the official support options.
After the registration you'll automatically get a "Verified User" role on the server and access to the
#download channels. You can also send a message to a member with support role to discuss the issue in private.
Be aware, that the support is only available on business days and the response may be delayed by up to 24 hours (in some cases more), so make sure to:
- Provide a clear and concise description of the issue and step-by-step instructions on how to reproduce it.
- Specify Naninovel and Unity versions you're using, target platform (Android, iOS, WebGL, etc) and operating system you're running the editor under (Windows, Mac or Linux).
- Attach a log file containing error or warning messages related to the issue.
Attaching a reproduction project greatly increases the chances to identify and fix the issue as soon as possible.
Support capability is limited; to ensure all users receive equal attention, please note the following:
- The support is limited to Naninovel-specific topics only. For anything Unity-related (eg, build UIs with uGUI, set up addressable system, write C# scripts, etc) see the information above;
- Don't expect the support to provide samples for your specific needs. We may suggest how to achieve a custom feature, but providing reference implementations is not something we can help with; consider hiring professional developers for that;
- Don't excessively ping/mention (via
@) or send private messages to the support or developers; this won't expedite the answer, but will instead make us temporary mute you;
- Feel free to discuss any Naninovel-related topics in
#devtalkchannels, but please only use
#supportwhen you seek attention from the support stuff; use threads if you find the channel too noisy.
Violating any of the above guidelines may result in 24-hours mute on the server; in the extreme cases the mute can be extended.
Of course, basic communication etiquette is expected from all users; any of the following will result in a temporary or even permanent ban:
- Threatening, abusive, vulgar, disrespectful or otherwise offensive behaviour;
- Asset Store reviews manipulation (using negative reviews to extort special attention);
- Spam or advertising of products and services not related to Naninovel;
- Illegally sharing copyrighted, personal or sensitive information and assets.
When reporting an issue, we may ask you to share a "repro" project. Reproduction project is a clean new Unity project containing only the bare minimum modifications and additional assets required to reproduce the issue.
Follow the steps below to create and share a reproduction project:
Reproduction project should be a new clean Unity project, not the one you're experiencing the issue with. Do not just copy all the assets from one project to another; it's important to isolate the issue by reproducing it in a clean environment, free from any custom configurations and assets, that are not directly affecting the issue.
Import the latest available Naninovel version; in case a pre-release version is available (via
#downloadchannel on our Discord server), use it instead.
Add the required assets and modify the project to reproduce the issue. Please keep naninovel scripts as short as possible and only add assets that are essential to replicate the issue. Make sure you're not adding any third-party plugins, extensions or any sort of custom C# scripts. In case a C# script is required for reproduction, ensure it contains only the code required to reproduce the issue.
Do not modify contents or add/delete anything inside the
Naninovelfolder; we're not providing support for modified versions of the package.
Create a "repro.txt" text file at the root project directory and specify step-by-step instructions on how to reproduce the issue, eg:
1. Open scene "SampleScene". 2. Enter play mode in the editor. 3. Start a new game. 4. Play through to the line number 15. 5. Save and load the game.
Then add what you've expected to happen and what is actually happening, eg:
Expected: Music "Ambient" should start playing. Actual: No music is playing.
Close Unity editor and remove all the files and folders at the root project directory, except the previously created "repro.txt" file and "Assets", "Packages" and "ProjectSettings" folders. Most importantly, make sure to delete "Library" folder, as it contains a lot of auto-generated files, which significantly increase project size.
Archive (zip) the project folder and either attach it to a private message in Discord or upload to a private file hosting (eg, Google Drive with a restricted access).
Remember to share reproduction projects only via private messages; never share the projects via public channels to prevent leaking personal data and copyrighted assets.