This is an official tiny wrapper library that helps you forget about UTF-8 conversions in the new CS2D versions. The library replaces the msg, msg2, print and parse functions to always use UTF-8. The library has a safeguard against being loaded multiple times, so it should be safe to include in your mod or script without additional considerations.

When using this library for UTF-8 strings in your code, make sure to save your .lua files as UTF-8 without BOM!

In case you need raw access to UTF-8 helper functions, the library provides the following:

utf8.codepoint(char) [number] - get the Unicode codepoint of the given character.
utf8.encode(char) [string] - get the UTF-8 representation of a single character.
utf8.convert(str) [string] - get a CS2D-ready UTF-8 representation of the given string.

After loading this library, UTF-8 conversion works as follows:

utf8.convert("欢迎来到CS2D") gives
utf8.convert("Привет CS2D!") gives

Hello
And I find another Bug,
If you want say something by using addhook('say','_say')
it's like dont work.

Gaios Here's a patch for that.



To anyone using this script I'd recommend using an alias for utf8.convert

You may add exception for

@ SQ: @ Gaios:
Thank you
Finally I success

@ TobyInChina: Autorun folder is executed after all scripts. You do it wrong.

@ SQ:
I've run UTF in the AutoRun folder

Good script! Fixes another design flaw in the cs2d Lua API.

Why are utf8len and utf8sub private?

Note to scripters
If you use code similar to this

Using this script will break it. You can add a fix by doing this


This will cause problems with existing scripts, especially if this file becomes included by default.

Any script using code similar to the above snippet or using the © symbol and saving as ASCII will be broken.

One fix is for scripters to always use code like the second snippet above. Another would be for this library to return invalid utf-8 as byte(s) or to provide new functions instead of overwriting existing ones.

This should be considered before possibly including this with CS2D and for anyone wanting to use this script on their servers (you might need to make changes to existing scripts).

@ TobyInChina:

Also you have loaded UTF after printing your line.

I use you lua.but It maybe dont work!
Help!!!

Thank God.

@ SQ:
Yea, it working, thanks. I just made a mistake in my code and wrote

instead


well, now everything is alright

Great work here

@ SQ: I didn't even download it

@ 2Gen: @ Gaios:
There is nothing you need to additionally do. It's a wrapper.


Gaiyos code won't even work because it's double converting.

Oh, this is exactly what I was looking for, thanks. But can you explain how to get the colored text using this script, since I always have it yellow.

Thank you

Must be included by default...
but then nobody uses wrapper.lua because of unclear up-to-date state.

Thumbs up.

                                                                             

@ Infinite Rain: The intricacies of editing to be able to painlessly include files, as well as the question of the library being potentially redistributed with mods and required multiple times, means that an old-fashioned safeguard is easier to do. If you want to use the require toolchain, just use , provided your is modified accordingly.