# `bevy_easy_localize`
[](https://crates.io/crates/bevy_easy_localize)
A simple crate to localize your game using .csv files.
## Features
- Loading from `.csv` files
- Loading the translation file from the asset folder
- Hot reloading
- Lightweight
## Upcoming features
- Per-language fonts
- More flexible and customizable `.csv` file loading
## How to use
The `.csv` file currently must be arranged in this order:
|word|comment|translation0|translation1|...|

In your project:
```rust
use bevy::prelude::*;
use bevy_easy_localize::Localize;
pub fn main() {
App::new()
.add_plugins(DefaultPlugins)
//Add the plugin
.add_plugin(bevy_easy_localize::LocalizePlugin)
//Insert an empty resource
.insert_resource(Localize::empty())
.add_startup_system(init_localize)
.add_system(translate)
.run();
}
fn init_localize(asset_server:Res<AssetServer>,mut localize:ResMut<Localize>){
//Set the handle
localize.set_handle(asset_server.load("test.csv"));
}
fn translate(
keyboard:Res<Input<KeyCode>>,
mut localize:ResMut<Localize>,
){
//Easily set the language
localize.set_language("German");
if keyboard.just_pressed(KeyCode::Space){
//Use the get() method to get a translated word for the specified keyword
println!("{}",localize.get("start_game"));
}
}
```
## Examples
- [`simple`](examples/simple.rs) – Reading from a file to initialize the resource.
- [`asset`](examples/asset.rs) – Using asset handles to initialize the resource.
## Bevy Compatibility
|bevy|bevy_easy_localize|
|---|---|
|0.9|0.1|
## About
I made this crate for my personal projects.
The obvious alternative is [`bevy_fluent`](https://github.com/kgv/bevy_fluent), but my goal is to just translate some text and
I don't need all of the fancy features it offers.
I will definitely be updating this crate and if you want to add a feature, please submit a pull request.