Author Topic: [XP] AzDesign Localization  (Read 3552 times)

Offline azdesign

  • Awakened Visionist
  • **
  • Posts: 64
  • LV: 2
  • Gender: Male
    • View Profile
[XP] AzDesign Localization
« on: September 06, 2012, 09:53:23 AM »
AzDesign Localization
Authors: AzDesign
Version: 1.0
Type: Multilingual Game Tool
Key Term: Game Utility

Introduction

Do you want people can play your games without any language restriction ? This script add a simple functionality to store dialogues in different languages. Each dialogue has different IDs and the game will search its text according to the what language has been set. The language files itself are simple .txt file, which everyone can add and modify it freely without having to learn specific scripting skills. Grab the demo now


Features

1. Easy to create and modify language files, all you need is a notepad++ (recommended). The file will be saved as common .txt
2. Support non-standard characters such as chinese and japanese characters
3. A debug feature that will detect any text error such as bad/duplicate IDs and text missing/too big/too many lines.
4. Automatically add lines after specific word that have reached the maximum message window width limit.
5. Different configuration which affect the script behavior such as :
  a. Dialogue search method :
      -Cached : Upon game start or language changes, all dialogue files will be stored in memory and sorted by their IDs for faster access
      -Streaming : Always re-read the file for specific dialogue. You change the language file and look at the result directly while the game running
  b. Localization error behavior :
      -Strict : Halt and exit upon receiving text error. Intended for final release which make sure the dialogue files are in normal condition.
      -Loose : Tolerate most error for debugging purpose. Both method always show which line produce this error
  c. Line splitting method :
      -Word : Adding new line after specific word that have reach width limit, best for most language
      -Char : Adding new line after specific character that have reach width limit, best for japanese language


Spoilers

(click to show/hide)


Demo

Please make sure to set the library to RGSS103J, otherwise, the script will hung up. The demo has already set with RGSS103J
Please make sure to set your system locale into japanese to display non-standard character properly

http://www.mediafire.com/?vscc64d5y1wqy5h


Script
(click to show/hide)


Instructions

1. Using the script :
The demo contains most of explanation that will help you use it

2. Creating Language file
-Download and install notepad++, very recommended
-Set the encoding as "UTF-8 without BOM"
(click to show/hide)
-There are 3 different sections required for a language file :
(click to show/hide)
Line 1 - Contains the language name and credits to the author, format : "(name of the language)-(credits)"
Line 2 - Contains the Line Splitting Method, which should be "word" or "char". Decide which suit the language best
Starting at line 3 - Contain the dialogue, which paired by ID and its text. format : "(ID)=(text)" ID can only consist of combination of alphabets, underscores and digits while text can be anything. If you want to add new line in the middle of the text, add "\n", that will tell the game to break the text into new line.
-Save the file as .txt file. The filename should be an obvious country small name such as English = ENG, Japan = JP, Indonesia = INA, etc. For example, english language file will be ENG.txt.
-Change the language, please refer to the demo on how to change the language


Compatibility

Not compatible with most other custom message script. For now, I cannot take any request for compatibility script as I got very busy working on my projects. Maybe later. Feel free to make your own compatibility script, I will link them here later  :)


Credits and Thanks

Credit to AzDesign for the script
Thanks to everyone who has answered my question in different topic I posted in the past. :haha:
Thanks to ForeverZer0 whose Localization script become my learning base.  ;)


License

Creative Commons - Attribution-NonCommercial-ShareAlike 3.0 Unported
( http://creativecommons.org/licenses/by-nc-sa/3.0/ )

You are free:

to Share - to copy, distribute and transmit the work
to Remix - to adapt the work

Under the following conditions:

Attribution. You must attribute the work in the manner specified by the author or licensor (but not in any way that suggests that they endorse you or your use of the work).

Noncommercial. You may not use this work for commercial purposes.

Share alike. If you alter, transform, or build upon this work, you may distribute the resulting work only under the same or similar license to this one.

- For any reuse or distribution, you must make clear to others the license terms of this work. The best way to do this is with a link to this web page.

- Any of the above conditions can be waived if you get permission from the copyright holder.

- Nothing in this license impairs or restricts the author's moral rights.


Author Notes

I have spent several hours checking bugs but if you find any, please tell me  ;)
« Last Edit: September 08, 2012, 12:02:34 PM by azdesign »
~ Check out my deviantart http://my-az-design.deviantart.com/ ~

Offline Blizzard

  • This sexy
  • Administrator
  • has over 9000 posts
  • *****
  • Posts: 19916
  • LV: 642
  • Gender: Male
  • Magic midgets.
    • View Profile
    • You're already on it. (-_-')
Re: [XP] AzDesign Localization
« Reply #1 on: September 06, 2012, 10:04:21 AM »
*fixes header*
*moves*
Make sure the next time to apply the header properly. This is important for the PHP script to display this topic in the script database index.
Check out Daygames and our games:

King of Booze      King of Booze: Never Ever      Pet Bots
Drinking Game for Android      Never have I ever for Android      Pet Bots for Android
Drinking Game for iOS      Never have I ever for iOS      Pet Bots for iOS
Drinking Game on Steam


Quote from: winkio
I do not speak to bricks, either as individuals or in wall form.

Quote from: Barney Stinson
When I get sad, I stop being sad and be awesome instead. True story.

Offline azdesign

  • Awakened Visionist
  • **
  • Posts: 64
  • LV: 2
  • Gender: Male
    • View Profile
Re: [XP] AzDesign Localization
« Reply #2 on: September 06, 2012, 10:14:08 AM »
 :^_^': Lol I didn't know there is header standard for this, is there is a reference for this I can read for the future I wrote another topic ?
~ Check out my deviantart http://my-az-design.deviantart.com/ ~

Offline Blizzard

  • This sexy
  • Administrator
  • has over 9000 posts
  • *****
  • Posts: 19916
  • LV: 642
  • Gender: Male
  • Magic midgets.
    • View Profile
    • You're already on it. (-_-')
Re: [XP] AzDesign Localization
« Reply #3 on: September 06, 2012, 10:25:20 AM »
Either take any other topic or use the template directly from this topic: http://forum.chaos-project.com/index.php/topic,17.0.html
Check out Daygames and our games:

King of Booze      King of Booze: Never Ever      Pet Bots
Drinking Game for Android      Never have I ever for Android      Pet Bots for Android
Drinking Game for iOS      Never have I ever for iOS      Pet Bots for iOS
Drinking Game on Steam


Quote from: winkio
I do not speak to bricks, either as individuals or in wall form.

Quote from: Barney Stinson
When I get sad, I stop being sad and be awesome instead. True story.

Offline azdesign

  • Awakened Visionist
  • **
  • Posts: 64
  • LV: 2
  • Gender: Male
    • View Profile
Re: [XP] AzDesign Localization
« Reply #4 on: September 08, 2012, 12:13:25 PM »
@Blizzard : Thanks, I'll use that for future reference.

ADDED : Spoilers and Script

For those who wondering, is this the same as ForeverZer0's Localization from  : http://forum.chaos-project.com/index.php/topic,12164.0.html,
No, we are using different method to get the text from the file. Also, mine has that text error finding feature and has automatic line splitting for text exceeding message window's width. I thought his script was very useful for my project, I was about to use it, but still, it doesn't have the features I wanted so I create one myself.  :)

Don't forget to change system locale into corresponding language for displaying non-standard characters such as japanese and chinese. Example, if you want to display chinese characters, set your computer system locale into chinese. For the rest of the language that using alphabets, you don't have to change anything.
« Last Edit: September 08, 2012, 12:16:41 PM by azdesign »
~ Check out my deviantart http://my-az-design.deviantart.com/ ~