From 68c703bd7da275411cee35cf02c8cc91450406f4 Mon Sep 17 00:00:00 2001
From: tastekim <tastekim@kakao.com>
Date: Wed, 11 Oct 2023 11:27:34 +0900
Subject: [PATCH] translate-kr commit

---
 index-kr.html                   | 137 +++++++++++
 index.html                      | 126 +++++++---
 v3.0-kr/README.md               |  33 +++
 v3.0-kr/_coverpage.md           |  18 ++
 v3.0-kr/_navbar.md              |   7 +
 v3.0-kr/_sidebar.md             |  24 ++
 v3.0-kr/doc/ally.md             | 256 ++++++++++++++++++++
 v3.0-kr/doc/camera.md           |  77 ++++++
 v3.0-kr/doc/collision_system.md | 118 ++++++++++
 v3.0-kr/doc/decoration.md       |  60 +++++
 v3.0-kr/doc/enemy.md            | 377 ++++++++++++++++++++++++++++++
 v3.0-kr/doc/examples.md         |  56 +++++
 v3.0-kr/doc/forces.md           |  55 +++++
 v3.0-kr/doc/getting-started.md  | 137 +++++++++++
 v3.0-kr/doc/input.md            | 176 ++++++++++++++
 v3.0-kr/doc/joystick.md         |  63 +++++
 v3.0-kr/doc/lighting.md         |  44 ++++
 v3.0-kr/doc/loading_assets.md   | 100 ++++++++
 v3.0-kr/doc/map.md              | 299 ++++++++++++++++++++++++
 v3.0-kr/doc/mixins.md           | 402 ++++++++++++++++++++++++++++++++
 v3.0-kr/doc/overview.md         | 131 +++++++++++
 v3.0-kr/doc/path_finding.md     |  50 ++++
 v3.0-kr/doc/player.md           | 328 ++++++++++++++++++++++++++
 v3.0-kr/doc/scene_builder.md    |  58 +++++
 v3.0-kr/doc/sensor.md           |  39 ++++
 v3.0-kr/doc/tiled_support.md    |  76 ++++++
 v3.0-kr/doc/util.md             | 154 ++++++++++++
 v3.0/_navbar.md                 |   7 +
 28 files changed, 3373 insertions(+), 35 deletions(-)
 create mode 100644 index-kr.html
 create mode 100644 v3.0-kr/README.md
 create mode 100644 v3.0-kr/_coverpage.md
 create mode 100644 v3.0-kr/_navbar.md
 create mode 100644 v3.0-kr/_sidebar.md
 create mode 100644 v3.0-kr/doc/ally.md
 create mode 100644 v3.0-kr/doc/camera.md
 create mode 100644 v3.0-kr/doc/collision_system.md
 create mode 100644 v3.0-kr/doc/decoration.md
 create mode 100644 v3.0-kr/doc/enemy.md
 create mode 100644 v3.0-kr/doc/examples.md
 create mode 100644 v3.0-kr/doc/forces.md
 create mode 100644 v3.0-kr/doc/getting-started.md
 create mode 100644 v3.0-kr/doc/input.md
 create mode 100644 v3.0-kr/doc/joystick.md
 create mode 100644 v3.0-kr/doc/lighting.md
 create mode 100644 v3.0-kr/doc/loading_assets.md
 create mode 100644 v3.0-kr/doc/map.md
 create mode 100644 v3.0-kr/doc/mixins.md
 create mode 100644 v3.0-kr/doc/overview.md
 create mode 100644 v3.0-kr/doc/path_finding.md
 create mode 100644 v3.0-kr/doc/player.md
 create mode 100644 v3.0-kr/doc/scene_builder.md
 create mode 100644 v3.0-kr/doc/sensor.md
 create mode 100644 v3.0-kr/doc/tiled_support.md
 create mode 100644 v3.0-kr/doc/util.md
diff --git a/index-kr.html b/index-kr.html
new file mode 100644
index 0000000..bf54e44
--- /dev/null
+++ b/index-kr.html
@@ -0,0 +1,137 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+    <meta charset="UTF-8">
+    <title>Bonfire</title>
+    <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1"/>
+    <meta name="description" content="(RPG maker) Create RPG-style or similar games with Flutter.">
+    <meta name="viewport"
+          content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
+    <link rel="apple-touch-icon" sizes="57x57" href="/favicon/apple-icon-57x57.png">
+    <link rel="apple-touch-icon" sizes="60x60" href="/favicon/apple-icon-60x60.png">
+    <link rel="apple-touch-icon" sizes="72x72" href="/favicon/apple-icon-72x72.png">
+    <link rel="apple-touch-icon" sizes="76x76" href="/favicon/apple-icon-76x76.png">
+    <link rel="apple-touch-icon" sizes="114x114" href="/favicon/apple-icon-114x114.png">
+    <link rel="apple-touch-icon" sizes="120x120" href="/favicon/apple-icon-120x120.png">
+    <link rel="apple-touch-icon" sizes="144x144" href="/favicon/apple-icon-144x144.png">
+    <link rel="apple-touch-icon" sizes="152x152" href="/favicon/apple-icon-152x152.png">
+    <link rel="apple-touch-icon" sizes="180x180" href="/favicon/apple-icon-180x180.png">
+    <link rel="icon" type="image/png" sizes="192x192" href="/favicon/android-icon-192x192.png">
+    <link rel="icon" type="image/png" sizes="32x32" href="/favicon/favicon-32x32.png">
+    <link rel="icon" type="image/png" sizes="96x96" href="/favicon/favicon-96x96.png">
+    <link rel="icon" type="image/png" sizes="16x16" href="/favicon/favicon-16x16.png">
+    <link rel="manifest" href="/favicon/manifest.json">
+    <meta name="msapplication-TileColor" content="#ffffff">
+    <meta name="msapplication-TileImage" content="/favicon/ms-icon-144x144.png">
+    <meta name="theme-color" content="#ffffff">
+    <link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify/themes/dark.css">
+    <link rel="stylesheet" href="//cdn.jsdelivr.net/npm/@ky_wong/docsify-version-plugin@1.0.2/style.css">
+    <link rel="stylesheet" href="//cdn.jsdelivr.net/npm/@ky_wong/docsify-version-plugin@1.0.2/custom-style.css">
+    <!-- Google tag (gtag.js) -->
+    <script async src="https://www.googletagmanager.com/gtag/js?id=G-XW6XTLBWR6"></script>
+    <script>
+        window.dataLayer = window.dataLayer || [];
+
+        function gtag() {
+            dataLayer.push(arguments);
+        }
+
+        gtag('js', new Date());
+
+        gtag('config', 'G-XW6XTLBWR6');
+    </script>
+    <style>
+        /* 기본 스타일 설정 */
+        body {
+            font-family: 'Arial', sans-serif;
+        }
+
+        .nav-dropdown-container {
+            position: relative;
+            display: inline-block;
+        }
+
+        .nav-dropdown-container > a {
+            text-decoration: none;
+            color: #333; /* 글자 색상 */
+            padding: 10px 15px;
+            border: none;
+            background-color: #f8f8f8; /* 배경색 */
+            cursor: pointer;
+            border-radius: 4px;
+            transition: background-color 0.3s;
+        }
+
+        .nav-dropdown-container > a:hover {
+            background-color: #e7e7e7; /* 호버 시 배경색 변경 */
+        }
+
+        .nav-dropdown {
+            display: none;
+            position: absolute;
+            right: 0; /* 우측 정렬 */
+            top: 100%; /* 상위 요소 바로 아래 */
+            border: 1px solid #ccc;
+            border-radius: 4px;
+            background-color: #f8f8f8;
+            z-index: 1000; /* 다른 요소 위에 표시 */
+        }
+
+        .nav-dropdown a {
+            display: block;
+            padding: 10px 15px;
+            color: #333;
+            text-decoration: none;
+        }
+
+        .nav-dropdown a:hover {
+            background-color: #e7e7e7;
+        }
+
+        /* 마우스 호버 시 드롭다운 표시 */
+        .nav-dropdown-container:hover .nav-dropdown {
+            display: block;
+        }
+
+        .version-selector {
+            width: 100%;
+        }
+    </style>
+</head>
+
+<body>
+<div id="app"></div>
+<script>
+    let versions = [
+        // {folder: '', label: 'v2.x', default: false},
+        {folder: 'v3.0-kr/', label: 'v3.x', default: true}
+    ];
+    let basePath = sessionStorage.getItem('basePath');
+    if (basePath == null) {
+        let defaultVersion = versions.find((v) => v.default).folder;
+        sessionStorage.setItem('basePath', defaultVersion);
+    }
+    const versionFolder = sessionStorage.getItem('basePath');
+
+    window.$docsify = {
+        name       : 'Bonfire',
+        repo       : 'https://github.com/bonfire-engine/bonfire-engine.github.io',
+        loadSidebar: true,
+        coverpage  : true,
+        // auto2top: true,
+        loadNavbar          : true,
+        maxLevel            : 4,
+        subMaxLevel         : 2,
+        basePath            : '/v3.0-kr/',
+        versions            : versions,
+        versionSelectorLabel: 'Version',
+    };
+</script>
+<script src="//cdn.jsdelivr.net/npm/docsify@4"></script>
+<script src="//cdn.jsdelivr.net/npm/docsify/lib/plugins/search.min.js"></script>
+<script src="//cdn.jsdelivr.net/npm/docsify-copy-code/dist/docsify-copy-code.min.js"></script>
+<script src="//cdn.jsdelivr.net/npm/@ky_wong/docsify-version-plugin@1.0.2/index.js"></script>
+</body>
+
+</html>
diff --git a/index.html b/index.html
index 1689de2..42a0c39 100644
--- a/index.html
+++ b/index.html
@@ -4,10 +4,10 @@
 <head>
   <meta charset="UTF-8">
   <title>Bonfire</title>
-  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
+  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1"/>
   <meta name="description" content="(RPG maker) Create RPG-style or similar games with Flutter.">
   <meta name="viewport"
-    content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
+        content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
   <link rel="apple-touch-icon" sizes="57x57" href="/favicon/apple-icon-57x57.png">
   <link rel="apple-touch-icon" sizes="60x60" href="/favicon/apple-icon-60x60.png">
   <link rel="apple-touch-icon" sizes="72x72" href="/favicon/apple-icon-72x72.png">
@@ -32,12 +32,68 @@
   <script async src="https://www.googletagmanager.com/gtag/js?id=G-XW6XTLBWR6"></script>
   <script>
     window.dataLayer = window.dataLayer || [];
-    function gtag(){dataLayer.push(arguments);}
+
+    function gtag() {
+      dataLayer.push(arguments);
+    }
+
     gtag('js', new Date());
 
     gtag('config', 'G-XW6XTLBWR6');
   </script>
   <style>
+    /* 기본 스타일 설정 */
+    body {
+      font-family: 'Arial', sans-serif;
+    }
+
+    .nav-dropdown-container {
+      position: relative;
+      display: inline-block;
+    }
+
+    .nav-dropdown-container > a {
+      text-decoration: none;
+      color: #333;
+      padding: 10px 15px;
+      border: none;
+      background-color: #f8f8f8;
+      cursor: pointer;
+      border-radius: 4px;
+      transition: background-color 0.3s;
+    }
+
+    .nav-dropdown-container > a:hover {
+      background-color: #e7e7e7;
+    }
+
+    .nav-dropdown {
+      display: none;
+      position: absolute;
+      right: 0;
+      top: 100%;
+      border: 1px solid #ccc;
+      border-radius: 4px;
+      background-color: #f8f8f8;
+      z-index: 1000;
+    }
+
+    .nav-dropdown a {
+      display: block;
+      padding: 10px 15px;
+      color: #333;
+      text-decoration: none;
+    }
+
+    .nav-dropdown a:hover {
+      background-color: #e7e7e7;
+    }
+
+    /* 마우스 호버 시 드롭다운 표시 */
+    .nav-dropdown-container:hover .nav-dropdown {
+      display: block;
+    }
+
     .version-selector {
       width: 100%;
     }
@@ -45,37 +101,37 @@
 </head>
 
 <body>
-  <div id="app"></div>
-  <script>
-    let versions = [
-      { folder: '', label: 'v2.x', default: false },
-      { folder: 'v3.0/', label: 'v3.x', default: true }
-    ];
-    let basePath = sessionStorage.getItem("basePath");
-    if (basePath == null) {
-      let defaultVersion = versions.find((v) => v.default).folder;
-      sessionStorage.setItem("basePath", defaultVersion);
-    }
-    const versionFolder = sessionStorage.getItem("basePath");
-  
-    window.$docsify = {
-      name: 'Bonfire',
-      repo: 'https://github.com/bonfire-engine/bonfire-engine.github.io',
-      loadSidebar: true,
-      coverpage: true,
-      // auto2top: true,
-      loadNavbar: true,
-      maxLevel: 4,
-      subMaxLevel: 2,
-      basePath: sessionStorage.getItem("basePath"),
-      versions: versions,
-      versionSelectorLabel: 'Version',
-    }
-  </script>
-  <script src="//cdn.jsdelivr.net/npm/docsify@4"></script>
-  <script src="//cdn.jsdelivr.net/npm/docsify/lib/plugins/search.min.js"></script>
-  <script src="//cdn.jsdelivr.net/npm/docsify-copy-code/dist/docsify-copy-code.min.js"></script>
-  <script src="//cdn.jsdelivr.net/npm/@ky_wong/docsify-version-plugin@1.0.2/index.js"></script>
+<div id="app"></div>
+<script>
+  let versions = [
+    {folder: '', label: 'v2.x', default: false},
+    {folder: 'v3.0/', label: 'v3.x', default: true}
+  ];
+  let basePath = sessionStorage.getItem('basePath');
+  if (basePath == null) {
+    let defaultVersion = versions.find((v) => v.default).folder;
+    sessionStorage.setItem('basePath', defaultVersion);
+  }
+  const versionFolder = sessionStorage.getItem('basePath');
+
+  window.$docsify = {
+    name       : 'Bonfire',
+    repo       : 'https://github.com/bonfire-engine/bonfire-engine.github.io',
+    loadSidebar: true,
+    coverpage  : true,
+    // auto2top: true,
+    loadNavbar          : true,
+    maxLevel            : 4,
+    subMaxLevel         : 2,
+    basePath            : sessionStorage.getItem('basePath'),
+    versions            : versions,
+    versionSelectorLabel: 'Version',
+  };
+</script>
+<script src="//cdn.jsdelivr.net/npm/docsify@4"></script>
+<script src="//cdn.jsdelivr.net/npm/docsify/lib/plugins/search.min.js"></script>
+<script src="//cdn.jsdelivr.net/npm/docsify-copy-code/dist/docsify-copy-code.min.js"></script>
+<script src="//cdn.jsdelivr.net/npm/@ky_wong/docsify-version-plugin@1.0.2/index.js"></script>
 </body>
 
-</html>
\ No newline at end of file
+</html>
diff --git a/v3.0-kr/README.md b/v3.0-kr/README.md
new file mode 100644
index 0000000..08b730f
--- /dev/null
+++ b/v3.0-kr/README.md
@@ -0,0 +1,33 @@
+# Bonfire 에 오신 것을 환영합니다(v3.0)
+
+> [FlameEngine](https://flame-engine.org/)의 힘으로 RPG 게임 등을 만들어보세요!
+
+[![Powered by Flame](https://img.shields.io/badge/Powered%20by-%F0%9F%94%A5-orange.svg)](https://flame-engine.org)
+[![Flutter](https://img.shields.io/badge/Made%20with-Flutter-blue.svg)](https://flutter.dev/)
+[![pub 패키지](https://img.shields.io/pub/v/bonfire.svg)](https://pub.dev/packages/bonfire)
+
+![](../_media/example.gif)
+
+## Bonfire 란?
+
+Bonfire는 쉽고 객관적이며 빠른 방법으로 Flutter 게임을 만드는 목적으로 만들어졌습니다!
+
+이 도구는 [FlameEngine](https://flame-engine.org/)을 기반으로 구축되었으며 해당 도구의 모든 리소스와 클래스를 Bonfire와 함께 사용할 수 있습니다. 그러므로 Bonfire로 작업을 시작하기 전에 [FlameEngine](https://flame-engine.org/)을 살펴보는 것이 좋습니다.
+
+이는 다음과 같은 관점에서 게임을 구축하는 데 이상적입니다.
+
+![](../_media/perspectiva.png)
+
+## 예시
+
+Bonfire가 사용되는 모습을 보려면 웹 [예제](/doc/examples?id=bonfire-example)를 확인하세요.
+
+## 기부
+
+Bonfire 가 도움이 된다고 생각하거나 가치 있다고 생각한다면 기부를 고려해 보세요. [BuyMeACoffee](https://www.buymeacoffee.com/rafaelbarbosa)로 도와주신다면 감사합니다. ❤️
+
+## 커뮤니티
+
+Fireslime's Discord에 Bonfire 도움말 채널이 있습니다. [여기](https://discord.com/invite/pxrBmy4) 또는 텔레그램 그룹 [여기](https://t.me/bonfire_engine)에 가입하세요.
+
+[FlameCon](https://www.youtube.com/watch?v=2DdiNrAAuBg&t=2s)에서 Bonfire 프레젠테이션을 진행했습니다.
diff --git a/v3.0-kr/_coverpage.md b/v3.0-kr/_coverpage.md
new file mode 100644
index 0000000..dcd099f
--- /dev/null
+++ b/v3.0-kr/_coverpage.md
@@ -0,0 +1,18 @@
+![logo](../_media/bonfire.gif)
+
+# Bonfire <small>v3.x</small>
+
+> Flutter를 사용하여 RPG 스타일 또는 유사한 게임을 쉽게 만드세요.
+
+- [Flame](https://flame-engine.org/)을 기반으로 제작된 2D 게임 엔진
+
+[![](https://img.shields.io/github/forks/rafaelbarbosatec/bonfire.svg?style=flat&logo=github&colorB=orange&label=forks)](https://github.com/RafaelBarbosatec/bonfire)
+[![](https://img.shields.io/github/stars/rafaelbarbosatec/bonfire.svg?style=flat&logo=github&colorB=orange&label=stars)](https://github.com/RafaelBarbosatec/bonfire)
+
+
+[Github](https://github.com/RafaelBarbosatec/bonfire)
+[Demo](https://bonfire-engine.github.io/examples/bonfire-v3)
+[Know more](#welcome-to-bonfire-under-construction)
+
+![color](#3f3f3f)
+
diff --git a/v3.0-kr/_navbar.md b/v3.0-kr/_navbar.md
new file mode 100644
index 0000000..5b240d1
--- /dev/null
+++ b/v3.0-kr/_navbar.md
@@ -0,0 +1,7 @@
+- <div class="nav-dropdown-container">
+      <a>Languages</a>
+      <div class="nav-dropdown">
+          <a href="/bonfire-engine.github.io/index.html#">English</a>
+          <a href="/bonfire-engine.github.io/index-kr.html#">한국어</a>
+      </div>
+  </div>
diff --git a/v3.0-kr/_sidebar.md b/v3.0-kr/_sidebar.md
new file mode 100644
index 0000000..45e2ad7
--- /dev/null
+++ b/v3.0-kr/_sidebar.md
@@ -0,0 +1,24 @@
+
+* [환영합니다!](/?id=welcome-to-bonfire-under-construction)
+* [시작하기](doc/getting-started.md?id=get-started)
+* [시작하기 전에](doc/overview.md?id=overview)
+* [지도](doc/map.md?id=map)
+* [플레이어](doc/player.md?id=player)
+* [적](doc/enemy.md?id=enemy)
+* [협력자](doc/ally.md?id=ally)
+* [꾸미기](doc/decoration.md?id=decoration)
+* [입력](doc/input.md?id=input)
+* [조이스틱](doc/joystick.md?id=joystick)
+* [카메라](doc/camera.md?id=camera)
+* [충돌 시스템](doc/collision_system.md?id=collision-system)
+* [조명](doc/lighting.md?id=lighting)
+* [센서](doc/sensor.md?id=sensor)
+* [힘](doc/forces.md?id=forces)
+* [유용한 믹스인](doc/mixins.md?id=mixins)
+* [자산 불러오기](doc/loading_assets.md?id=loading-sprites-and-spriteanimations)
+* [타일 지원](doc/tiled_support.md?id=tiled-support)
+* [장면(Scene) 빌더](doc/scene_builder.md?id=scene_builder)
+* [경로 찾기](doc/path_finding.md?id=pathfinding)
+* [유틸리티](doc/util.md?id=util)
+* [예제 프로젝트](doc/examples.md?id=bonfire-example)
+
diff --git a/v3.0-kr/doc/ally.md b/v3.0-kr/doc/ally.md
new file mode 100644
index 0000000..c04df8f
--- /dev/null
+++ b/v3.0-kr/doc/ally.md
@@ -0,0 +1,256 @@
+# 협력자
+
+> <small>이것은 [Npc](https://github.com/RafaelBarbosatec/bonfire/blob/v3.0.0/lib/npc/npc.dart)이며 다음을 사용합니다.
+[공격 가능](mixins?id=attackable) 믹스인.</small>
+
+
+플레이어 동맹 NPC입니다. 그래서 적으로부터 데미지를 받을 수도 있고, 적에게 데미지를 줄 수도 있습니다.
+
+적에는 'SimpleAlly', 'RotationAlly', 'PlatformAlly'의 세 가지 유형이 있습니다.
+
+## 기본 협력자(SimpleAlly)
+
+> <small>이것은 [동맹](#ally)이며 사용
+[DirectionAnimation](mixins?id=directionanimation) 믹스인.</small>
+
+45° 및 67.5° 원근에 사용됩니다. 모든 방향(위, 아래, 왼쪽, 오른쪽, 위_오른쪽, 위_왼쪽, 아래_왼쪽, 아래_오른쪽)에 대한 모션 애니메이션을 구성할 수 있습니다.
+
+이를 사용하려면 적을 대표하고 SimpleAlly를 확장하는 클래스를 생성하기만 하면 됩니다.
+
+```dart
+
+class Human extends SimpleAlly {
+
+    Human(Vector2 position)
+      : super(
+          position: position, //required
+          size: Vector2(32.0,32.0), //required
+          life: 100,
+          speed: 100,
+          initDirection: Direction.right,
+          animation: SimpleDirectionAnimation(
+            idleLeft: Future<SpriteAnimation>(), 
+            idleRight: Future<SpriteAnimation>(), //required
+            runLeft: Future<SpriteAnimation>(), 
+            runRight: Future<SpriteAnimation>(), //required
+            idleUp: Future<SpriteAnimation>(),
+            idleDown: Future<SpriteAnimation>(),
+            idleUpLeft: Future<SpriteAnimation>(),
+            idleUpRight: Future<SpriteAnimation>(),
+            idleDownLeft: Future<SpriteAnimation>(),
+            idleDownRight: Future<SpriteAnimation>(),
+            runUp: Future<SpriteAnimation>(),
+            runDown: Future<SpriteAnimation>(),
+            runUpLeft: Future<SpriteAnimation>(),
+            runUpRight: Future<SpriteAnimation>(),
+            runDownLeft: Future<SpriteAnimation>(),
+            runDownRight: Future<SpriteAnimation>(),
+          ),
+      );
+
+    @override
+    void update(double dt) {
+      // 필요한 로직을 작성하세요.
+      super.update(dt);
+    }
+
+    @override
+    void render(Canvas canvas) {
+      // 필요한 로직을 작성하세요.
+      super.render(canvas);
+    }
+}
+
+```
+
+이제 적을 나타내는 클래스가 있으므로 적의 동작을 구성할 수 있습니다.
+
+이 작업에 도움이 되는 `update` 메소드 내에서 사용할 수 있는 몇 가지 유용한 확장이 있습니다.
+
+
+```dart 
+  void simpleAttackMelee({
+     required double damage,
+    required Vector2 size,
+    int? id,
+    int interval = 1000,
+    bool withPush = false,
+    double? sizePush,
+    Direction? direction,
+    Future<SpriteAnimation>? animationRight,
+    VoidCallback? execute,
+    Vector2? centerOffset,
+  })
+```
+플레이어에게 물리적 공격을 가해 설정된 빈도로 설정된 피해를 입힙니다. 이 공격을 나타내는 애니메이션을 추가할 수 있습니다.
+
+
+```dart 
+  void simpleAttackRange({
+    required Future<SpriteAnimation> animationRight,
+    required Future<SpriteAnimation> animationDestroy,
+    required Vector2 size,
+    Vector2? destroySize,
+    int? id,
+    double speed = 150,
+    double damage = 1,
+    Direction? direction,
+    int interval = 1000,
+    bool withCollision = true,
+    ShapeHitbox? collision,
+    VoidCallback? onDestroy,
+    VoidCallback? execute,
+    LightingConfig? lightingConfig,
+  })
+```
+원거리 공격을 실행합니다. 'FlyingAttackObject'를 게임에 추가하고 구성된 방향으로 전송되어 충돌하는 사람에게 약간의 피해를 주거나 장벽(충돌 타일)에 부딪힐 때 파괴됩니다.
+
+
+```dart 
+  void seeAndMoveToAttackRange({
+    Function(Enemy)? positioned,
+    Function(Enemy)? observed,
+    VoidCallback? notObserved,
+    double radiusVision = 32,
+    double? visionAngle,
+    double? angle,
+    double? minDistanceFromPlayer,
+    bool runOnlyVisibleInScreen = true,
+  })
+```
+적이 반경 내에 있으면 아군은 원거리 공격을 수행하기 위해 위치를 잡습니다. 공격 위치에 도달하면 `positioned` 콜백이 실행됩니다.
+
+
+그리고 모든 `GameComponent' 메소드. [GameComponent 함수](#TODO) 살펴보기
+
+
+### 애니메이션 변경
+
+`SimpleAlly` 애니메이션을 업데이트하려면 다음 방법을 사용해야 합니다:
+
+```dart
+
+  replaceAnimation(SimpleDirectionAnimation());
+
+```
+
+순간 애니메이션을 재생하려면 'SimpleDirectionAnimation' 메서드를 사용해야 합니다. 예를 들어:
+
+```dart
+
+  animation.playOnce(
+    FutureOr<SpriteAnimation> animation, {
+    VoidCallback? onFinish,
+    VoidCallback? onStart,
+    bool runToTheEnd = false,
+    bool flipX = false,
+    bool flipY = false,
+    bool useCompFlip = false,
+    Vector2? size,
+    Vector2? offset,
+  );
+  animation.pause();
+  animation.resume();
+
+```
+
+
+## 회전하는 협력자(RotationAlly)
+
+> <small>이것은 [협력자](#ally)이며 사용
+[UseSpriteAnimation](mixins?id=usespriteanimation),
+[UseAssetsLoader](mixins?id=useassetsloader).</small>
+
+
+90° 원근에 사용됩니다. 그리고 실행 및 유휴에 대한 모션 애니메이션을 구성할 수 있습니다.
+
+```dart
+
+class Tank extends RotationAlly {
+
+    Tank(Vector2 position)
+      : super(
+          position: position, //required
+          animIdle: Future<SpriteAnimation>(), //required
+          animRun: Future<SpriteAnimation>(), //required
+          size: Vector2(32.0,32.0), //required
+          life: 100,
+          speed: 100,
+          currentRadAngle: -1.55, 
+      );
+
+    @override
+    void update(double dt) {
+      // 필요한 로직을 작성하세요.
+      super.update(dt);
+    }
+
+    @override
+    void render(Canvas canvas) {
+      // 필요한 로직을 작성하세요.
+      super.render(canvas);
+    }
+}
+
+```
+
+이제 적을 나타내는 클래스가 있으므로 그들의 동작을 구성할 수 있습니다.
+
+이러한 움직임을 구성하는 데 도움이 되는 '업데이트'에서 사용할 수 있는 몇 가지 유용한 확장 기능이 있습니다.
+
+
+```dart 
+  void seeAndMoveToAttackRange({
+    Function(Enemy)? positioned,
+    VoidCallback? notObserved,
+    Function(Enemy)? observed,
+    double radiusVision = 32,
+    double? visionAngle,
+    double? angle,
+    double? minDistanceFromPlayer,
+    bool runOnlyVisibleInScreen = true,
+  })
+```
+
+```dart 
+  void simpleAttackMelee({
+    required Future<SpriteAnimation> animationRight,
+    required double damage,
+    required Vector2 size,
+    int? id,
+    bool withPush = true,
+    double? radAngleDirection,
+    VoidCallback? execute,
+    int interval = 1000,
+    double marginFromCenter = 16,
+    Vector2? centerOffset,
+  })
+```
+
+```dart 
+  void simpleAttackRange({
+    required Future<SpriteAnimation> animation,
+    required Future<SpriteAnimation> animationDestroy,
+    required Vector2 size,
+    Vector2? destroySize,
+    double? radAngleDirection,
+    int? id,
+    double speed = 150,
+    double damage = 1,
+    int interval = 1000,
+    bool withDecorationCollision = true,
+    VoidCallback? onDestroy,
+    ShapeHitbox? collision,
+    VoidCallback? onExecute,
+    LightingConfig? lightingConfig,
+    Vector2? centerOffset,
+    double marginFromOrigin = 16, 
+  })
+  
+```
+
+그리고 모든 `GameComponent' 메소드. [GameComponent 함수](#TODO) 살펴보기
+
+## 커스텀
+
+이러한 유형의 적 중 어느 것도 귀하의 요구를 충족시키지 못하는 경우. `Ally` 클래스를 확장하여 자신만의 것을 만들 수 있습니다.
diff --git a/v3.0-kr/doc/camera.md b/v3.0-kr/doc/camera.md
new file mode 100644
index 0000000..b389178
--- /dev/null
+++ b/v3.0-kr/doc/camera.md
@@ -0,0 +1,77 @@
+# 카메라
+
+> 카메라 컨트롤러
+
+카메라에서 일부 설정을 구성할 수 있습니다.
+
+```dart
+  return BonfireWidget(
+    ...
+   cameraConfig: CameraConfig(
+      moveOnlyMapArea: false, // 카메라는 지도 외부 영역을 표시하지 않고 지도 영역만 이동하려고 합니다.
+      movementWindow: Vector2(50,50), // 카메라를 움직이지 않고도 중앙 화면에서 플레이어가 움직일 수 있는 영역입니다.
+      speed: 1.0, // 카메라 속도
+      zoom:  1.0,
+      angle: 45 * pi/180, // 뷰를 45도 회전
+      startFollowPlayer: true,
+      speed: double.infinity,
+      target: GameComponent(), // 기본적으로 대상은 플레이어입니다.
+      initPosition: Vector2(),
+      initialMapZoomFit = InitialMapZoomFitEnum.none, // none,fitWidth,fitHeight,fit
+   ),
+  );
+```
+
+게임 중에 사용할 수 있는 유용한 기능:
+
+```dart
+   gameRef.camera.moveToPositionAnimated(
+   {
+      required Vector2 position,
+      EffectController? effectController,
+      double? zoom,
+      double? angle,
+      Function()? onComplete,
+   }
+   )
+
+   gameRef.camera.moveToTargetAnimated({
+      required PositionComponent target,
+      EffectController? effectController,
+      double? zoom,
+      double? angle,
+      Function()? onComplete,
+      bool followTarget = true,
+   })
+
+   gameRef.camera.moveToPlayer();
+
+   gameRef.camera.moveToPlayerAnimated({
+      EffectController? effectController,
+      Function()? onComplete,
+      double? zoom,
+      double? angle,
+   })
+
+   gameRef.camera.animateZoom({
+      required Vector2 zoom,
+      EffectController? effectController,
+      Function()? onComplete,
+   })
+
+   gameRef.camera.animateAngle({
+      required double angle,
+      EffectController? effectController,
+      Function()? onComplete,
+   })
+
+   gameRef.camera.follow(
+      PositionProvider target, {
+      double maxSpeed = double.infinity,
+      bool horizontalOnly = false,
+      bool verticalOnly = false,
+      bool snap = false,
+   })
+
+   gameRef.camera.shake({double intensity = 10.0, Duration? duration})
+```
diff --git a/v3.0-kr/doc/collision_system.md b/v3.0-kr/doc/collision_system.md
new file mode 100644
index 0000000..08c99fa
--- /dev/null
+++ b/v3.0-kr/doc/collision_system.md
@@ -0,0 +1,118 @@
+# 충돌 시스템
+
+> 객체 간의 충돌을 결정하고 구성하는 시스템
+
+
+## 사용 방법
+
+3.0 버전에서는 [Flame CollisionDetection](https://docs.flame-engine.org/latest/flame/collision_Detection.html)을 사용하는 모든 충돌 시스템입니다.
+
+컴포넌트에 충돌을 추가하려면 다음과 같이 'ShapeHitbox'(PolygonHitbox, RectangleHitbox 또는 CircleHitbox)를 추가하면 됩니다.
+
+```dart
+
+class MyComponent extends SimplePlayer {
+  //...
+  @override
+  Future<void> onLoad() {
+    add(RectangleHitbox(size:size));
+    return super.onLoad();
+  }
+}
+
+```
+
+그 후 Flame은 게임 내 히트박스 간의 모든 충돌을 감지합니다. 이 메서드를 재정의하여 이 내용을 들을 수 있습니다.
+
+
+```dart
+
+class MyCollidable extends SimplePlayer {
+  //...
+  @override
+  void onCollision(Set<Vector2> points, PositionComponent other) {
+    if (other is ScreenHitbox) {
+      //...
+    } else if (other is YourOtherComponent) {
+      //...
+    }
+  }
+
+  @override
+  void onCollisionEnd(PositionComponent other) {
+    if (other is ScreenHitbox) {
+      //...
+    } else if (other is YourOtherComponent) {
+      //...
+    }
+  }
+}
+
+```
+
+이제 충돌이 언제 발생하는지 알 수 있지만 충돌이 발생해도 구성 요소가 움직임을 멈추지는 않습니다. 그렇게 하려면 다음과 같이 `BlockMovementCollision` 믹스인을 추가하면 됩니다.
+
+```dart
+
+class MyComponent extends SimplePlayer with  BlockMovementCollision{
+  //...
+  @override
+  Future<void> onLoad() {
+    add(RectangleHitbox(size:size));
+    return super.onLoad();
+  }
+}
+
+```
+
+좋습니다! 이제 플레이어를 이동하고 `ShapeHitbox`를 사용하여 벽이나 다른 구성요소와 충돌하면 이동이 중지됩니다.
+
+## 누가 충돌했는지 알아내기
+
+`onBlockMovement` 또는 `onBlockedMovement`를 재정의하여 `GameComponent`가 충돌한 것을 알 수 있습니다.
+
+
+```dart
+
+class MyComponent extends SimplePlayer with  BlockMovementCollision{
+  //...
+  @override
+  Future<void> onLoad() {
+    add(RectangleHitbox(size:size));
+    return super.onLoad();
+  }
+
+  @override
+  bool onBlockMovement(
+    Set<Vector2> intersectionPoints,
+    GameComponent other,
+  ) {
+    // 충돌이 발생하면 뭔가를 할 수 있습니다. 따라서 false를 반환하면 차단 동작이 발생하지 않습니다.
+    return super.onBlockMovement(intersectionPoints,other);
+  }
+
+  @override
+  void onBlockedMovement(
+    GameComponent other,
+    Direction? direction,
+    Vector2 lastDisplacement,
+  ) {
+     super.onBlockedMovement(other,direction,lastDisplacement);
+     // 충돌로 인해 움직임이 차단되었을 때 뭔가를 할 수 있습니다.
+  }
+}
+```
+
+## 테스트 및 디버깅
+
+충돌이 올바른 위치에 있는지 확인하려면 `BonfireWidget`에서 `showCollisionArea`를 활성화하면 됩니다.
+
+```dart
+    BonfireWidget(
+        ...
+        showCollisionArea:true,
+        ...
+    ),
+```
+
+![](../../_media/show_collision.png)
diff --git a/v3.0-kr/doc/decoration.md b/v3.0-kr/doc/decoration.md
new file mode 100644
index 0000000..f145009
--- /dev/null
+++ b/v3.0-kr/doc/decoration.md
@@ -0,0 +1,60 @@
+# 꾸미기
+
+> <small>이것은 [AnimatedGameObject](objects#AnimatedGameObject)입니다.</small>
+
+풍경에 추가하고 싶은 모든 것. 예를 들어 간단한 통이나 플레이어와 상호 작용하는 NPC가 있습니다.
+
+다음 빌더를 사용하여 장식적이거나 대화형 개체를 만들 수 있습니다.
+
+일반적인 스프라이트로 꾸미기:
+```dart
+GameDecoration.withSprite(
+    FutureOr<Sprite> sprite, {
+    required Vector2 position, // 세계의 초기 위치 초기화
+    required Vector2 size,
+  })
+```
+
+스프라이트 애니메이션으로 꾸미기:
+```dart
+import 'package:flame/animation.dart' as FlameAnimation;
+
+GameDecoration.withAnimation(
+    FutureOr<SpriteAnimation> animation, {
+    required Vector2 position, // 세계의 초기 위치 초기화
+    required Vector2 size,
+  })
+```
+
+꾸미기에 사용자 정의 동작을 추가하려면 `GameDecoration`에서 확장하고 자신만의 클래스를 만드세요.
+```dart
+class MyCustomDecoration extends GameDecoration {
+  MyCustomDecoration(Vector2 position)
+      : super.withAnimation(
+          SpriteAnimation.load(
+            "itens/chest_spritesheet.png",
+            SpriteAnimationData.sequenced(
+              amount: 8,
+              stepTime: 0.1,
+              textureSize: Vector2(16, 16),
+            ),
+          ),
+          size: Vector2(32,32),
+          position: position,
+        );
+
+    @override
+    void update(double dt) {
+        // 필요한 로직을 작성하세요.
+        super.update(dt);
+    }
+
+    @override
+    void render(Canvas canvas) {
+        // 필요한 로직을 작성하세요.
+        super.render(canvas);
+    }
+}
+```
+
+커스텀 꾸미기의 더 많은 예시 보기: [torch](https://github.com/RafaelBarbosatec/bonfire/blob/master/example/lib/shared/decoration/torch.dart) & [chest](https://github.com/RafaelBarbosatec/bonfire/blob/master/example/lib/shared/decoration/chest.dart)
diff --git a/v3.0-kr/doc/enemy.md b/v3.0-kr/doc/enemy.md
new file mode 100644
index 0000000..c0c0de7
--- /dev/null
+++ b/v3.0-kr/doc/enemy.md
@@ -0,0 +1,377 @@
+# 적
+
+> <small>이것은 [Npc](https://github.com/RafaelBarbosatec/bonfire/blob/v3.0.0/lib/npc/npc.dart)이며 다음을 사용합니다.
+[공격 가능](mixins?id=attackable) 믹스인.</small>
+
+
+게임에서 적을 생성합니다. 이 클래스의 인스턴스에는 원하는 대로 사용하고 구성할 수 있는 미리 정의된 동작이 있습니다. 모든 동작과 움직임을 사용자 정의할 수 있습니다.
+
+적에는 'SimpleEnemy', 'RotationEnemy', 'PlatformEnemy'의 세 가지 유형이 있습니다.
+
+## 단순한 적(SimpleEnemy)
+
+> <small>이것은 [Enemy](#enemy)이며 사용
+[DirectionAnimation](mixins?id=directionanimation) 믹스인.</small>
+
+<img width=100 src="_media/simple_enemy.png"></img>
+
+45° 및 67.5° 원근에 사용됩니다. 모든 방향(위, 아래, 왼쪽, 오른쪽, 위_오른쪽, 위_왼쪽, 아래_왼쪽, 아래_오른쪽)에 대한 모션 애니메이션을 구성할 수 있습니다.
+
+이를 사용하려면 적을 나타내는 클래스를 만들고 SimpleEnemy를 확장하면 됩니다.
+
+```dart
+
+class Goblin extends SimpleEnemy {
+
+    Goblin(Vector2 position)
+      : super(
+          position: position, //required
+          size: Vector2(32.0,32.0), //required
+          life: 100,
+          speed: 100,
+          initDirection: Direction.right,
+          animation: SimpleDirectionAnimation(
+            idleLeft: Future<SpriteAnimation>(), 
+            idleRight: Future<SpriteAnimation>(), //required
+            runLeft: Future<SpriteAnimation>(), 
+            runRight: Future<SpriteAnimation>(), //required
+            idleUp: Future<SpriteAnimation>(),
+            idleDown: Future<SpriteAnimation>(),
+            idleUpLeft: Future<SpriteAnimation>(),
+            idleUpRight: Future<SpriteAnimation>(),
+            idleDownLeft: Future<SpriteAnimation>(),
+            idleDownRight: Future<SpriteAnimation>(),
+            runUp: Future<SpriteAnimation>(),
+            runDown: Future<SpriteAnimation>(),
+            runUpLeft: Future<SpriteAnimation>(),
+            runUpRight: Future<SpriteAnimation>(),
+            runDownLeft: Future<SpriteAnimation>(),
+            runDownRight: Future<SpriteAnimation>(),
+          ),
+      );
+
+    @override
+    void update(double dt) {
+      // 필요한 로직을 작성하세요.
+      super.update(dt);
+    }
+
+    @override
+    void render(Canvas canvas) {
+      // 필요한 로직을 작성하세요.
+      super.render(canvas);
+    }
+}
+
+```
+
+이제 적을 나타내는 클래스가 있으므로 적의 동작을 구성할 수 있습니다.
+
+이 작업에 도움이 되는 `update` 메소드 내에서 사용할 수 있는 몇 가지 유용한 확장이 있습니다.
+
+
+```dart 
+  void seePlayer({
+    required Function(Player) observed,
+    VoidCallback? notObserved,
+    double radiusVision = 32,
+    double? visionAngle, // 기본값 6.28319(360도)
+    double? angle,
+  })
+```
+플레이어가 적의 radiusVision 내에 있으면 콜백 함수가 트리거됩니다.
+
+
+```dart 
+  void seeAndMoveToPlayer({
+    required Function(Player) closePlayer,
+    VoidCallback? notObserved,
+    VoidCallback? observed,
+    VoidCallback? notCanMove,
+    double radiusVision = 32,
+    double margin = 10,
+    double? visionAngle, // 기본값 6.28319(360도)
+    double? angle,
+    bool runOnlyVisibleInScreen = true, 
+  })
+```
+적이 RadiusVision 내에 들어오면 플레이어 방향으로 이동합니다. 플레이어에 가까워지면 'closePlayer'가 실행됩니다.
+
+
+```dart 
+  void simpleAttackMelee({
+     required double damage,
+    required Vector2 size,
+    int? id,
+    int interval = 1000,
+    bool withPush = false,
+    double? sizePush,
+    Direction? direction,
+    Future<SpriteAnimation>? animationRight,
+    VoidCallback? execute,
+    Vector2? centerOffset,
+  })
+```
+플레이어에게 물리적 공격을 가해 설정된 빈도로 설정된 피해를 입힙니다. 이 공격을 나타내는 애니메이션을 추가할 수 있습니다.
+
+
+```dart 
+  void simpleAttackRange({
+    required Future<SpriteAnimation> animationRight,
+    required Future<SpriteAnimation> animationDestroy,
+    required Vector2 size,
+    Vector2? destroySize,
+    int? id,
+    double speed = 150,
+    double damage = 1,
+    Direction? direction,
+    int interval = 1000,
+    bool withCollision = true,
+    ShapeHitbox? collision,
+    VoidCallback? onDestroy,
+    VoidCallback? execute,
+    LightingConfig? lightingConfig,
+  })
+```
+원거리 공격을 실행합니다. 'FlyingAttackObject'를 게임에 추가하고 구성된 방향으로 전송되어 충돌하는 사람에게 약간의 피해를 주거나 장벽(충돌 타일)에 부딪힐 때 파괴됩니다.
+
+
+```dart 
+  void seeAndMoveToAttackRange({
+    Function(Player)? positioned,
+    Function(Player)? observed,
+    VoidCallback? notObserved,
+    double radiusVision = 32,
+    double? visionAngle,
+    double? angle,
+    double? minDistanceFromPlayer,
+    bool runOnlyVisibleInScreen = true,
+  })
+```
+플레이어가 반경 내에 있으면 적이 원거리 공격을 수행할 위치를 잡습니다. 공격 위치에 도달하면 `positioned` 콜백이 실행됩니다.
+
+
+그리고 모든 `GameComponent' 메소드. [GameComponent 함수](#TODO) 살펴보기
+
+
+### 애니메이션 변경
+
+`SimpleEnemy` 애니메이션을 업데이트하려면 다음 방법을 사용해야 합니다:
+
+```dart
+
+  replaceAnimation(SimpleDirectionAnimation());
+
+```
+
+순간 애니메이션을 재생하려면 'SimpleDirectionAnimation' 메서드를 사용해야 합니다. 예를 들어:
+
+```dart
+
+  animation.playOnce(
+    FutureOr<SpriteAnimation> animation, {
+    VoidCallback? onFinish,
+    VoidCallback? onStart,
+    bool runToTheEnd = false,
+    bool flipX = false,
+    bool flipY = false,
+    bool useCompFlip = false,
+    Vector2? size,
+    Vector2? offset,
+  );
+  animation.pause();
+  animation.resume();
+
+```
+
+참고: 적들은 카메라에 보일 때만 움직입니다. 이를 비활성화하려면 충돌 구성의 `collisionOnlyVisibleScreen`에 false를 추가하세요. [콜리전 시스템](collision_system)을 참조하세요.
+
+SimpleEnemy 예제는 [여기](https://github.com/RafaelBarbosatec/bonfire/blob/master/example/lib/shared/enemy/goblin.dart)에서 완료하세요.
+
+
+## 회전 적(RotationEnemy)
+
+> <small>이것은 [적](https://github.com/RafaelBarbosatec/bonfire/blob/v2.4.0/lib/npc/enemy/enemy.dart)이며 다음을 사용합니다.
+[UseSpriteAnimation](mixins?id=usespriteanimation),
+[UseAssetsLoader](mixins?id=useassetsloader).</small>
+
+<img width=100 src="_media/rotation_enemy.png"></img>
+
+90° 원근에 사용됩니다. 그리고 실행 및 유휴에 대한 모션 애니메이션을 구성할 수 있습니다.
+
+```dart
+
+class Tank extends RotationEnemy {
+
+    Tank(Vector2 position)
+      : super(
+          position: position, //required
+          animIdle: Future<SpriteAnimation>(), //required
+          animRun: Future<SpriteAnimation>(), //required
+          size: Vector2(32.0,32.0), //required
+          life: 100,
+          speed: 100,
+          currentRadAngle: -1.55, 
+      );
+
+    @override
+    void update(double dt) {
+      // 필요한 로직을 작성하세요.
+      super.update(dt);
+    }
+
+    @override
+    void render(Canvas canvas) {
+       // 필요한 로직을 작성하세요.
+      super.render(canvas);
+    }
+}
+
+```
+
+이제 적을 나타내는 클래스가 있으므로 그들의 동작을 구성할 수 있습니다.
+
+이러한 움직임을 구성하는 데 도움이 되는 '업데이트'에서 사용할 수 있는 몇 가지 유용한 확장 기능이 있습니다.
+
+```dart 
+  void seePlayer({
+    required Function(Player) observed,
+    VoidCallback? notObserved,
+    double radiusVision = 32,
+    double? visionAngle, // 기본값 6.28319(360도)
+    double? angle,
+  })
+```
+
+```dart 
+ void seeAndMoveToPlayer({
+    required Function(Player) closePlayer,
+    VoidCallback? notObserved,
+    double radiusVision = 32,
+    double margin = 10,
+    bool runOnlyVisibleInScreen = true,
+  })
+```
+
+```dart 
+  void seeAndMoveToAttackRange({
+    required Function(Player) positioned,
+    VoidCallback? notObserved,
+    double radiusVision = 32,
+    double? minDistanceCellsFromPlayer,
+    bool runOnlyVisibleInScreen = true,
+  })
+```
+
+```dart 
+  void simpleAttackMelee({
+    required Future<SpriteAnimation> animationRight,
+    required double damage,
+    required Vector2 size,
+    int? id,
+    bool withPush = true,
+    double? radAngleDirection,
+    VoidCallback? execute,
+    int interval = 1000,
+    double marginFromCenter = 16,
+    Vector2? centerOffset,
+  })
+```
+
+```dart 
+  void simpleAttackRange({
+    required Future<SpriteAnimation> animation,
+    required Future<SpriteAnimation> animationDestroy,
+    required Vector2 size,
+    Vector2? destroySize,
+    double? radAngleDirection,
+    int? id,
+    double speed = 150,
+    double damage = 1,
+    int interval = 1000,
+    bool withDecorationCollision = true,
+    VoidCallback? onDestroy,
+    ShapeHitbox? collision,
+    VoidCallback? onExecute,
+    LightingConfig? lightingConfig,
+    Vector2? centerOffset,
+    double marginFromOrigin = 16, 
+  })
+  
+```
+
+그리고 모든 `GameComponent' 메소드. [GameComponent 함수](#TODO) 살펴보기
+
+
+## 플랫폼 적(PlatformEnemy)
+
+> <small>이것은 [SimpleEnemy](#SimpleEnemy)이며 다음을 사용합니다.
+[블록이동충돌](#TODO),
+[점프](#TODO)
+및 [점프 애니메이션](#TODO)</small>
+
+플랫폼 게임에 사용됩니다. 그리고 달리기, 정적인 상태, 점프에 대한 모션 애니메이션을 구성할 수 있습니다.
+
+```dart
+
+class BowserEnemy extends PlatformEnemy {
+
+    BowserEnemy(vector2 position)
+      : super(
+        position: position, //required
+        animation: PlatformAnimations(), //required
+        size: Vector.all(32), //required
+        life: 100,
+        speed: 100,
+        countJumps: 1,
+      );
+}
+
+```
+
+### 점프
+
+플레이어 점프를 수행하려면 [Jumper mixin](#TODO) 메서드를 사용할 수 있습니다.
+
+```dart
+  jump({double? jumpSpeed, bool force = false});
+
+```
+
+
+### 애니메이션 변경
+
+`PlatformEnemy` 애니메이션을 업데이트하려면 다음 방법을 사용해야 합니다:
+
+```dart
+
+  replacePlatformAnimation(PlatformAnimations());
+
+```
+
+순간 애니메이션을 재생하려면 'SimpleDirectionAnimation' 메서드를 사용해야 합니다. 예를 들어:
+
+```dart
+
+  animation.playOnce(
+    FutureOr<SpriteAnimation> animation, {
+    VoidCallback? onFinish,
+    VoidCallback? onStart,
+    bool runToTheEnd = false,
+    bool flipX = false,
+    bool flipY = false,
+    bool useCompFlip = false,
+    Vector2? size,
+    Vector2? offset,
+  );
+  animation.pause();
+  animation.resume();
+
+```
+
+> OBS: 올바른 동작을 위해서는 이 구성 요소에 중력을 추가한다는 것을 기억해야 합니다. [HandleForces](#TODO) 살펴보기
+
+
+## 커스텀
+
+이러한 유형의 적 중 어느 것도 귀하의 요구를 충족시키지 못하는 경우. `Enemy` 클래스를 확장하여 자신만의 것을 만들 수 있습니다.
diff --git a/v3.0-kr/doc/examples.md b/v3.0-kr/doc/examples.md
new file mode 100644
index 0000000..f6d7a96
--- /dev/null
+++ b/v3.0-kr/doc/examples.md
@@ -0,0 +1,56 @@
+## Bonfire Example
+[GitHub](https://github.com/RafaelBarbosatec/bonfire/tree/v3.0.0/example)    -   [Play other tab](https://bonfire-engine.github.io/examples/bonfire-v3/)
+
+![Bonfire example](https://bonfire-engine.github.io/examples/bonfire-v3 ':include :type=iframe width=100% height=500px') 
+
+## SunnyPlace [In development]
+> Game case
+
+[PlayStore](https://play.google.com/store/apps/details?id=br.com.sunnyplace)
+
+![](../../_media/sunnyplace.gif)
+
+## Darkness Dungeon
+[GitHub](https://github.com/RafaelBarbosatec/darkness_dungeon) - [PlayStore](https://play.google.com/store/apps/details?id=com.rafaelbarbosatec.darkness_dungeon)
+
+![](../../_media/example_darkness.gif)
+
+## Mini Fantasy
+
+[GitHub](https://github.com/RafaelBarbosatec/mini_fantasy)   -   [PLAY](https://bonfire-engine.github.io/examples/mini_fantasy/)
+
+![](../../_media/example_mini_fantasy.gif)
+
+## Light Shooter
+
+Online game that use [Nakama game server](https://flutter-nakama.gitbook.io/flutter-nakama/)
+
+[GitHub](https://github.com/RafaelBarbosatec/light_shooter) - 
+[Video](https://twitter.com/RafaBarbosaTec/status/1656049304413274113)
+
+![](../../_media/light_shoot.png)
+
+## Defector
+
+Game submitted to [Midyear 2022 Flame Game Jam](https://itch.io/jam/2nd-flame-game-jam/rate/1672215)
+
+[GitHub](https://github.com/RafaelBarbosatec/defector)   -   [PLAY](https://rafaelbarbosatec.itch.io/defector)
+
+![](../../_media/defector.gif)
+
+## Turn game
+
+[GitHub](https://github.com/RafaelBarbosatec/turn_game)
+
+![](https://raw.githubusercontent.com/RafaelBarbosatec/turn_game/main/img/screen%20_shot.png)
+
+
+## Npc neural
+
+신경망 퍼셉트론과 Bonfire 을 사용하여 NPC 훈련을 간단하게 구현
+
+
+[GitHub](https://github.com/RafaelBarbosatec/npc_neural_training)    -   [Play other tab](https://bonfire-engine.github.io/examples/neural-network)
+
+![Bonfire example](https://bonfire-engine.github.io/examples/neural-network ':include :type=iframe width=100% height=600px') 
+
diff --git a/v3.0-kr/doc/forces.md b/v3.0-kr/doc/forces.md
new file mode 100644
index 0000000..84a927f
--- /dev/null
+++ b/v3.0-kr/doc/forces.md
@@ -0,0 +1,55 @@
+# Forces
+
+모닥불은 간단한 힘 시스템을 가지고 있습니다. 게임에 선형, 가속 또는 저항력을 추가할 수 있습니다.
+
+| AccelerationForce2D | LinearForce2D    | ResistanceForce2D    |
+| :---:   | :---: | :---: |
+| ![](../../_media/force_acceleration.gif) | ![](../../_media/force_linear.gif)   | ![](../../_media/force_resistance.gif)   |
+
+
+## 사용법
+
+전역 힘을 추가하려면 Bonfire 위젯의 'globalForces' 매개변수에 추가하세요.
+
+
+```dart
+@override
+  Widget build(BuildContext context) {
+    return BonfireWidget(
+      //...
+      globalForces: [] // 여기서 가속(Acceleration Force 2D), 저항과 같은 힘을 추가할 수 있습니다.
+    );
+  }
+```
+
+네! 'HandleForces' 믹스인을 사용하는 모든 구성요소는 이 힘의 영향을 받습니다. 이와 같이:
+
+```dart
+class MyCustomDecoration extends GameDecoration with  HandleForces{
+
+
+}
+```
+
+특정 구성요소에 힘을 추가할 수 있습니다. 그냥 `HandleForces` 믹스인을 추가하고 `addForce` 함수를 호출하세요.
+
+
+```dart
+class MyCustomDecoration extends GameDecoration with  HandleForces{
+
+  MyCustomDecoration(){
+    addForce((AccelerationForce2D('gravity',Vector2(0,50))))
+    // 제거하려면 RemoveForce('gravity')를 사용합니다.
+  }
+}
+```
+
+## 사용 가능한 힘 
+
+- `AccelerationForce2D` -> 속도에 가속도 적용
+- `ResistanceForce2D` -> 0을 시도하는 속도에 저항을 적용합니다.
+- `LinearForce2D` -> 속도에 선형 힘 적용
+
+클래스를 생성하고 `Force2D`에서 확장하여 자신만의 `force`를 만들 수 있습니다.
+
+> component 의 질량도 편집할 수 있습니다. 그냥 `mass = 2`를 하세요;
diff --git a/v3.0-kr/doc/getting-started.md b/v3.0-kr/doc/getting-started.md
new file mode 100644
index 0000000..dec25ab
--- /dev/null
+++ b/v3.0-kr/doc/getting-started.md
@@ -0,0 +1,137 @@
+# 시작하기
+
+> 멋진 Bonfire 프로젝트를 시작해봅시다.
+
+## 설치하기
+
+1. 의존성 패키지 추가
+
+패키지의 pubspec.yaml 파일에 다음을 추가하세요.
+
+```yaml
+dependencies:
+  bonfire: ^3.x.x
+```
+
+2. 설치
+
+명령줄에서도 패키지를 설치할 수 있습니다.
+
+```
+$ flutter pub get
+```
+
+3. 추가
+
+이제 Dart 코드에서 다음을 사용할 수 있습니다.
+
+```dart
+import 'package:bonfire/bonfire.dart';
+```
+
+## 사용법
+
+### 맵 만들기
+[Tiled](https://www.mapeditor.org/)를 사용하여 지도를 만들어야 합니다. 그런 다음 지도를 json 파일로 내보낼 수 있습니다. [Bonfire에서 Tiled를 사용하는 방법에 대한 자세한 내용을 볼 수 있습니다](tiled_support)
+<br>
+[json 파일로 맵 내보내기에 대한 튜토리얼 비디오 보기](https://www.youtube.com/watch?v=hVCmLqZ0JVw)
+
+이제 지도를 보기 위해 실행할 수 있습니다:
+
+
+```dart
+@override
+  Widget build(BuildContext context) {
+    return BonfireWidget(
+      joystick: Joystick(
+        directional: JoystickDirectional(),
+      ), // required
+      map: WorldMapByTiled('tile/map.json'),
+    );
+  }
+```
+
+이렇게 하면 지도가 렌더링되는 것을 볼 수 있고 방향 조이스틱을 사용하여 탐색할 수 있습니다.
+
+
+### 플레이어 만들기
+
+플레이어를 생성하려면 SpriteAnimations가 필요합니다. [Flame 문서](https://docs.flame-engine.org/main/flame/rendering/images.html)에서 Sprite를 로드하는 방법을 확인할 수 있습니다.
+
+이 예제에 사용된 이미지는 다음과 같습니다.
+
+
+[![Idle](https://raw.githubusercontent.com/RafaelBarbosatec/bonfire/master/example/assets/images/player/knight_idle.png)](https://raw.githubusercontent.com/RafaelBarbosatec/bonfire/master/example/assets/images/player/knight_idle.png)
+
+[![Run](https://raw.githubusercontent.com/RafaelBarbosatec/bonfire/master/example/assets/images/player/knight_run.png)](https://raw.githubusercontent.com/RafaelBarbosatec/bonfire/master/example/assets/images/player/knight_run.png)
+
+
+```dart
+class PlayerSpriteSheet {
+ 
+  static Future<SpriteAnimation> get idleRight => SpriteAnimation.load(
+        "player/knight_idle.png",
+        SpriteAnimationData.sequenced(
+          amount: 6,
+          stepTime: 0.1,
+          textureSize: Vector2(16, 16),
+        ),
+      );
+
+  static Future<SpriteAnimation> get runRight => SpriteAnimation.load(
+        "player/knight_run.png",
+        SpriteAnimationData.sequenced(
+          amount: 6,
+          stepTime: 0.1,
+          textureSize: Vector2(16, 16),
+        ),
+      );
+
+  static SimpleDirectionAnimation get simpleDirectionAnimation =>
+      SimpleDirectionAnimation(
+        idleRight: idleRight,
+        runRight: runRight,
+      );
+}
+```
+
+
+플레이어를 생성하려면 클래스를 생성하고 `SimplePlayer`로 확장하면 됩니다. [Player in Bonfire 자세히 보기](플레이어)
+
+
+```dart
+
+class Knight extends SimplePlayer {
+    Knight(Vector2 position)
+      : super(
+          position: position, 
+          size: Vector2.all(32),
+          animation: PlayerSpriteSheet.simpleDirectionAnimation,
+      );
+}
+
+```
+
+이제 게임에 플레이어를 추가하기만 하면 됩니다.
+
+
+```dart
+@override
+  Widget build(BuildContext context) {
+    return BonfireWidget(
+      joystick: Joystick(
+        directional: JoystickDirectional(),
+      ), 
+      map: WorldMapByTiled('tile/map.json'),
+      player: Knight(Vector2(40,40))
+    );
+  }
+```
+
+그러면 지도에서 플레이어를 볼 수 있고 조이스틱 방향으로 움직일 수 있습니다.
+
+## 다음 단계
+
+Bonfire에서 사용할 수 있는 모든 구성 요소를 알아보세요. [여기 참조](개요)
+
+모든 예시를 볼 수 있습니다
diff --git a/v3.0-kr/doc/input.md b/v3.0-kr/doc/input.md
new file mode 100644
index 0000000..4ef1210
--- /dev/null
+++ b/v3.0-kr/doc/input.md
@@ -0,0 +1,176 @@
+# 입력
+
+
+## 제스처
+
+> Bonfire에서는 이러한 상호작용을 활성화하기 위해 믹스인을 사용합니다.
+
+Bonfire는 [Listener](https://api.flutter.dev/flutter/widgets/Listener-class.html) 위젯을 사용하여 제스처를 수신합니다.
+
+### 탭 제스처
+
+TapGesture를 활성화하려면 다음과 같이 구성 요소에 `TapGesture` 믹스인을 추가하면 됩니다.
+
+```dart
+
+class MyCustomDecoration extends GameDecoration with TapGesture {
+  MyCustomDecoration(Vector2 position)
+      : super.withAnimation(
+          Future<SpriteAnimation>(),
+          size: Vector2(32,32),
+          position: position,
+        );
+
+
+  // 컴포넌트에서 탭다운이 발생할 때 호출됩니다.
+  // 'true'를 반환하면 이 이벤트는 다른 구성요소로 전달되지 않습니다.(기본값 = false)
+  @override
+  bool onTapDown(GestureEvent event){
+    return super.onTapDown(event);
+  }
+
+  // 컴포넌트에서 탭업이 발생할 때 호출됩니다.
+  @override
+  void onTapUp(GestureEvent event){}
+
+  // 컴포넌트에서 탭 취소가 발생하면 호출됩니다.
+  @override
+  void onTapCancel(){}
+
+  // 컴포넌트를 탭할 때 호출됩니다.
+  @override
+  void onTap(){}
+
+  // 화면에서 아래로 탭할 때 호출됩니다.
+  void onTapDownScreen(GestureEvent event) {}
+  // 화면을 탭할 때 호출됩니다.
+  void onTapUpScreen(GestureEvent event) {}
+
+}
+```
+
+### 드래그 제스처
+
+DragGesture를 활성화하려면 다음과 같이 구성 요소에 `DragGesture` 믹스인을 추가하면 됩니다.
+
+```dart
+
+class MyCustomDecoration extends GameDecoration with DragGesture {
+  MyCustomDecoration(Vector2 position)
+      : super.withAnimation(
+          Future<SpriteAnimation>(),
+          size: Vector2(32,32),
+          position: position,
+        );
+
+}
+```
+
+드래그 동작을 사용하면 구성요소를 지도에서 자동으로 드래그할 수 있습니다.
+
+객체와의 상호 작용을 듣고 싶다면 다음 메서드를 재정의할 수 있습니다.
+
+```dart
+// 컴포넌트에서 별 드래그 동작이 수행될 때 호출됩니다.
+// 'true'를 반환하면 이 이벤트는 다른 구성요소로 전달되지 않습니다.(기본값 = false)
+bool startDrag(GestureEvent event) {
+  return super.startDrag(event);
+}
+//컴포넌트가 이동될 때 호출됩니다.
+void moveDrag(GestureEvent event) {}
+// 구성요소 드래그가 완료되면 호출됩니다.
+void endDrag(GestureEvent event) {}
+// 드래그가 취소될 때 호출됩니다.
+void cancelDrag(GestureEvent event) {}
+```
+
+### 커스텀
+
+모든 구성 요소는 `PointerDetectorHandler`를 확장하므로 제스처 이벤트를 수신하려면 `true`를 반환하는 `hash Gesture`를 재정의하세요.
+
+```dart
+  @override
+  bool hasGesture() => true;
+```
+
+이렇게 하면 이 메서드를 재정의하여 화면에서 제스처 이벤트를 들을 수 있습니다.
+
+```dart
+  void handlerPointerDown(PointerDownEvent event) {}
+  void handlerPointerMove(PointerMoveEvent event) {}
+  void handlerPointerUp(PointerUpEvent event) {}
+  void handlerPointerCancel(PointerCancelEvent event) {}
+  void handlerPointerHover(PointerHoverEvent event) {}
+  void handlerPointerSignal(PointerSignalEvent event) {}
+```
+
+## 마우스
+
+DragGesture를 활성화하려면 다음과 같이 구성 요소에 `MouseListener` 믹스인을 추가하면 됩니다.
+
+```dart
+
+class MyCustomDecoration extends GameDecoration with MouseEventListener {
+  MyCustomDecoration(Position position)
+      : super.withAnimation(
+          Future<SpriteAnimation>(),
+          size: Vector2(32,32),
+          position: position,
+        );
+
+}
+```
+
+객체와의 상호 작용을 듣고 싶다면 다음 메서드를 재정의할 수 있습니다.
+
+```dart
+  /// 화면 전체에 걸쳐 마우스 커서를 listen 합니다.
+  void onMouseHoverScreen(int pointer, Vector2 position) {}
+
+  /// 화면에서 버튼을 클릭한 상태에서 마우스 움직임을 listen 합니다.
+  void onMouseMoveScreen(int pointer, Vector2 position, MouseButton button) {}
+
+  /// 이 구성요소에 마우스 커서를 댈 때 listen 합니다.
+  void onMouseHoverEnter(int pointer, Vector2 position);
+
+  /// 마우스 커서가 이 컴포넌트 외부를 지나갈 때 listen 합니다.
+  void onMouseHoverExit(int pointer, Vector2 position);
+
+  /// 화면에서 마우스 스크롤을 사용할 때 listen 합니다.
+  void onMouseScrollScreen(
+      int pointer, Vector2 position, Vector2 scrollDelta) {}
+
+  /// 컴포넌트에서 마우스 스크롤을 사용할 때 listen 합니다.
+  void onMouseScroll(int pointer, Vector2 position, Vector2 scrollDelta);
+
+  /// 구성요소에서 마우스를 클릭할 때 listen 합니다.
+  void onMouseTapDown(int pointer, Vector2 position, MouseButton button) {}
+  /// 구성요소에서 마우스를 클릭할 때 listen 합니다.
+  void onMouseTapUp(int pointer, Vector2 position, MouseButton button) {}
+
+    // 구성요소에서 마우스를 클릭할 때 listen 합니다.
+  void onMouseTap(MouseButton button);
+
+  void onMouseCancel() {}
+```
+
+## 키보드
+
+키보드 이벤트를 들으려면 `KeyboardEventListener` 믹스인을 사용하세요.
+
+```dart
+
+class HumanPlayer extends SimplePlayer with KeyboardEventListener{
+  //...
+  @override
+  bool onKeyboard(
+    RawKeyEvent event,
+    Set<LogicalKeyboardKey> keysPressed,
+  ) {
+    return super.onKeyboard(event,keysPressed);
+  }
+
+}
+
+
+```
diff --git a/v3.0-kr/doc/joystick.md b/v3.0-kr/doc/joystick.md
new file mode 100644
index 0000000..a862385
--- /dev/null
+++ b/v3.0-kr/doc/joystick.md
@@ -0,0 +1,63 @@
+# 조이스틱
+
+> <small>이것은 [조이스틱 컨트롤러](https://github.com/RafaelBarbosatec/bonfire/blob/master/lib/joystick/joystick_controller.dart)입니다.</small>
+
+플레이어를 제어하는 구성요소입니다.
+
+## 조이스틱
+
+<img src="../../_media/screeShot_joystick.jpg" width="600"/>
+
+즉시 사용할 수 있는 구현(`조이스틱`)이 사전 포함되어 있지만 사용자 정의 모양을 추가하거나 원하는 만큼 많은 작업을 추가하도록 구성할 수도 있습니다.
+
+또는 `JoystickController`를 직접 구현하고 `JoystickListener`를 통해 이벤트를 내보낼 수도 있습니다.
+
+조이스틱은 다음 매개변수로 구성할 수 있습니다.
+```dart
+  return BonfireWidget(
+    joystick: Joystick(
+        keyboardConfig: KeyboardConfig(
+          enable: true, // 키보드 이벤트를 활성화하거나 비활성화하는 데 사용됩니다(기본값은 true).
+          acceptedKeys: [ // 허용된 특정 키를 전달할 수 있습니다. null인 경우 모든 키를 허용합니다.
+            LogicalKeyboardKey.space,
+          ],
+          keyboardDirectionalType: KeyboardDirectionalType.arrows, // 방향 유형(화살표 또는 wasd)
+        ), // 여기에서 키보드 상호 작용 수신을 활성화합니다.
+        directional: JoystickDirectional(
+          spriteBackgroundDirectional: Sprite.load('joystick_background.png'), // 컨트롤러 배경
+          spriteKnobDirectional: Sprite.load('joystick_knob.png'), // 컨트롤러 원 배경
+          color: Colors.black, // 'pathSpriteBackgroundDirectional' 또는 'pathSpriteKnobDirectional'을 전달하지 않으면 방향에 대한 색상을 정의할 수 있습니다.
+          size: 100, // 컨트롤러 제어 크기
+          isFixed: false, // 화면의 첫 번째 터치를 기준으로 동적 위치로 방향을 지정할 수 있습니다.
+        ),
+        actions: [
+          JoystickAction(
+            actionId: 1, // (required) 작업 식별값, 누르면 'void JoystickAction(JoystickActionEvent event) {}'로 전송됩니다.
+            sprite: Sprite.load('joystick_atack_range.png'), // 액션 이미지
+            spritePressed: Sprite.load('joystick_atack_range.png'), // 작업이 실행될 때 표시되는 선택적 이미지
+            spriteBackgroundDirection: Sprite.load('joystick_background.png'), // 컨트롤러 배경
+            enableDirection: true, // 방향성 작동 활성화
+            align: JoystickActionAlign.BOTTOM_RIGHT,
+            color: Colors.blue,
+            size: 50,
+            margin: EdgeInsets.only(bottom: 50, right: 160),
+          )
+        ],
+    ),
+    ...
+  );
+```
+
+[예제](https://github.com/RafaelBarbosatec/bonfire/blob/master/example/lib/main.dart)를 확인하세요.
+
+## 조이스틱 리스너
+
+조이스틱 상호작용을 듣는 데 사용되는 믹스인입니다.
+
+이 믹스인을 사용하는 구성 요소는 관찰자로 추가된 조이스틱 이벤트를 수신할 수 있습니다.
+
+```dart
+
+gameRef.addJoystickObserver(myComponentJoystickListener);
+
+```
diff --git a/v3.0-kr/doc/lighting.md b/v3.0-kr/doc/lighting.md
new file mode 100644
index 0000000..6c11ede
--- /dev/null
+++ b/v3.0-kr/doc/lighting.md
@@ -0,0 +1,44 @@
+# 조
+
+> <small>이것은 [GameComponent](https://github.com/RafaelBarbosatec/bonfire/blob/master/lib/base/game_comComponent.dart)입니다.</small>
+
+> 주의: 이 믹스인은 임펠러 버그로 인해 IOS 장치에서 제대로 작동하지 않습니다. [문제](https://github.com/flutter/flutter/issues/132849)를 살펴보세요.
+
+게임에 조명을 추가하는 역할을 담당하는 레이어입니다.
+
+<img width=400 src="../../_media/example_lighting.jpg"></img>
+
+BonfireWidget에서 `lightingColorGame` 속성을 설정하면 이 조명 시스템이 자동으로 활성화됩니다. 객체에 조명을 추가하려면 `Lighting` 믹스인을 구성 요소에 추가하고 `setupLighting()` 메서드를 사용하여 구성하면 됩니다.
+
+```dart
+class MyCustomDecoration extends GameDecoration with Lighting {
+  MyCustomDecoration(Position position)
+      : super.withAnimation(
+          Future<SpriteAnimation>(),
+          size: Vector2(32,32),
+          position: position,
+        ){
+          setupLighting(
+            LightingConfig(
+              radius: width * 1.5,
+              color: Colors.transparent,
+              // blurBorder: 20, // 이는 기본값입니다
+              // type: LightingType.circle, // 이는 기본값입니다
+              // useComponentAngle: false, // 이는 기본값입니다. 'angle' 매개변수를 변경할 때 실제 조명이 구성요소와 함께 회전하는 경우.
+            ),
+          );
+        }
+
+}
+```
+
+## 게임 색상 필터
+
+프로그래밍 방식으로 게임에 색상 필터를 적용할 수 있습니다.
+
+### BlendMode 및 색상
+
+```dart
+  gameRef.colorFilter.animateTo(Colors.blue, BlendMode.colorBurn);
+```
+
diff --git a/v3.0-kr/doc/loading_assets.md b/v3.0-kr/doc/loading_assets.md
new file mode 100644
index 0000000..3a50dd8
--- /dev/null
+++ b/v3.0-kr/doc/loading_assets.md
@@ -0,0 +1,100 @@
+# 스프라이트 및 스프라이트 애니메이션 로드
+
+> 이미지를 로드하여 스프라이트나 애니메이션 만들기
+
+이미지를 로드하려면 [flame](https://docs.flame-engine.org/main/flame/rendering/images.html)(기본 `assets/images/`)에 정의된 폴더 패턴을 따라야 합니다.
+
+```yaml
+
+flutter:
+  assets:
+    - assets/images/potion.png
+    - assets/images/player/runLeft.png
+```
+
+## Sprites
+
+스프라이트를 로드하려면:
+
+```dart
+
+Image image = await Flame.images.load('potion.png');
+final potion = Sprite(image,
+                  srcPosition: Vector2(0, 0),
+                  srcSize: Vector2(0,0)
+               );
+
+// or
+
+Sprite potion = await Sprite.load('potion.png',
+                  srcPosition: Vector2(0, 0),
+                  srcSize: Vector2(0,0)
+               );
+
+// or 
+
+Image image = await Flame.images.load('potion.png');
+final potion = image.getSprite(
+                  position: Vector2(0, 0),
+                  size: Vector2(0,0)
+               );
+
+```
+
+## SpritesAnimation
+
+이는 애니메이션을 형성하는 일련의 Sprite입니다. 다음과 같은 방법으로 만들 수 있습니다.
+
+```dart
+
+Image imagePlayerRunLeft = await Flame.images.load('player/runLeft.png');
+SpriteAnimation runLeft = SpriteAnimation.fromFrameData(
+    imagePlayerRunLeft,
+    SpriteAnimationData.sequenced(
+      amount: 5,
+      textureSize: Vector2(16.0, 16.0),
+      stepTime: 0.1,
+      texturePosition: Vector2.zero(),
+    ),
+);
+
+// or
+
+SpriteAnimation runLeft = await SpriteAnimation.load(
+      'player/runLeft.png',
+      SpriteAnimationData.sequenced(
+         amount: 5,
+         textureSize: Vector2.all(16),
+         stepTime: 0.1,
+         texturePosition: Vector2.zero(),
+      ),
+);
+
+// or
+
+Image imagePlayerRunLeft = await Flame.images.load('player/runLeft.png');
+
+SpriteAnimation runLeft = imagePlayerRunLeft.getAnimation(
+      position: Vector2(),
+      size: Vector2(),
+      amount: 5,
+      stepTime: 0.1,
+      loop: true,
+    );
+
+```
+
+
+## 이미지 병합
+
+이미지를 병합하여 동적 Sprite 또는 SpriteAnimation을 구축할 수 있습니다.
+이는 캐릭터의 베이스를 가져오고 특정 의상을 추가할지 여부에 매우 유용합니다.
+
+이를 수행하려면 Flame [ImageComposition](https://docs.flame-engine.org/1.0.0/images.html#imagecomposition)을 사용하십시오.
+
+
+## Fire Atlas
+
+[FireAtlas](https://github.com/flame-engine/fire-atlas)를 사용할 수 있습니다.
+
+Fire Atlas는 게임용 Texture Atlas를 생성하는 도구입니다.
diff --git a/v3.0-kr/doc/map.md b/v3.0-kr/doc/map.md
new file mode 100644
index 0000000..674f8ef
--- /dev/null
+++ b/v3.0-kr/doc/map.md
@@ -0,0 +1,299 @@
+# 지도
+
+> 게임이 진행되는 지도(또는 세계)를 나타냅니다.
+
+이는 아래와 같이 지도를 함께 조립하는 작은 타일의 매트릭스입니다.
+
+![](../../_media/map.png)
+
+## 사용법
+
+현재는 [Tiled](https://www.mapeditor.org/)를 사용하여 지도를 생성하는 것이 좋습니다. 이를 위해 `map` 매개변수의 `BonfireWidget`에 있는 `WorldMapByTiled`를 사용합니다.
+
+```dart
+WorldMapByTiled('tile/map.json', forceTileSize: Size(32,32))
+```
+
+첫 번째 매개변수(`tile/map.json`)는 Tiled에서 내보낸 `.json` 파일의 경로입니다.
+
+> 중요: Bonfire는 .json 파일만 지원합니다.
+
+두 번째 매개변수(`Size(32,32)`)는 선택사항이며 지도에 있는 각 타일의 크기(사각형)를 결정합니다. 설정하지 않으면 TileSet에서 정의한 기본 크기를 사용합니다.
+
+URL에서 지도를 로드할 수 있습니다. 경로에 URL을 전달하면 됩니다. 예시:
+
+```dart
+WorldMapByTiled(
+    'https://raw.githubusercontent.com/RafaelBarbosatec/rafaelbarbosatec.github.io/master/tiled/my_map.json',
+    forceTileSize: Size(32,32),
+)
+```
+
+## 개체 추가
+
+`registerObject` 메소드를 사용하여 [장식](장식) 및 [적](enemy)과 같은 객체를 지도에 추가할 수 있습니다.
+
+```dart
+    return BonfireWidget(
+        map: WorldMapByTiled(
+            'tiled/map.json',
+            forceTileSize: Size(32,32),
+            objectsBuilder: {
+                'orc': (TiledObjectProperties properties) => Orc(properties.position),
+            },
+        ),
+        ...
+    );
+```
+
+지도에 객체 레이어를 생성하고 위 이미지의 예처럼 위치를 지정하세요.
+
+Tiled 지원에 대한 자세한 내용을 보려면 [여기](tiled_support)를 클릭하세요.
+
+## 행렬로 지도 만들기
+
+다음과 같이 이중 배열을 사용하여 맵을 만들 수 있습니다.
+
+```dart
+
+[
+    [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
+    [0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 0, 0, 0, 0],
+    [0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0],
+    [0, 0, 0, 0, 1, 1, 1, 2, 1, 1, 0, 0, 0, 0],
+    [0, 0, 0, 0, 1, 1, 2, 2, 1, 1, 0, 0, 0, 0],
+    [0, 0, 0, 0, 1, 1, 2, 2, 1, 1, 0, 0, 0, 0],
+    [0, 0, 0, 0, 1, 1, 2, 1, 1, 1, 0, 0, 0, 0],
+    [0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0],
+    [0, 0, 0, 0, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0],
+    [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
+    [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
+]
+
+```
+
+이 기능은 라돔 맵을 생성할 수 있는 가능성을 열어줍니다. 임의의 알고리즘을 사용하여 [fast_noise](https://pub.dev/packages/fast_noise)와 같은 매트릭스를 생성하세요. [Bonfire 저장소](https://github.com/RafaelBarbosatec/bonfire/tree/master/example)에 이 패키지를 사용하는 예가 있습니다.
+
+그리고 더 나은 상태를 유지하기 위해 이 지도에 스프라이트를 추가하는 데 도움이 되는 클래스를 구현합니다. 'Terrain Builder'.
+
+### 기본 사용법
+
+이 리소스를 사용하는 방법은 매우 쉽습니다.
+
+```dart
+
+return BonfireWidget(
+      map: MatrixMapGenerator.generate(
+        axisInverted: true,
+        matrix: [
+          [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
+          [0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 0, 0, 0, 0],
+          [0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0],
+          [0, 0, 0, 0, 1, 1, 1, 2, 1, 1, 0, 0, 0, 0],
+          [0, 0, 0, 0, 1, 1, 2, 2, 1, 1, 0, 0, 0, 0],
+          [0, 0, 0, 0, 1, 1, 2, 2, 1, 1, 0, 0, 0, 0],
+          [0, 0, 0, 0, 1, 1, 2, 1, 1, 1, 0, 0, 0, 0],
+          [0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0],
+          [0, 0, 0, 0, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0],
+          [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
+          [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
+        ],
+        builder: (ItemMatrixProperties prop){
+
+            // prop.value; // 이것은 행렬 값입니다.
+            // prop.position; // 이것은 x와 y의 위치입니다.
+            // 이웃 값에 액세스할 수 있습니다.
+            // prop.valueTop;
+            // prop.valueTopLeft; 
+            // prop.valueTopRight;
+            // prop.valueBottom;
+            // prop.valueBottomLeft;
+            // prop.valueBottomRight; 
+            // prop.valueLeft; 
+            // prop.valueRight; 
+
+            TileModelSprite? sprite = TileModelSprite(
+                path:'tile_grass.png',
+            );
+            if(prop.value == 0){
+              sprite = TileModelSprite(
+                path:'tile_water.png',
+              );
+            }
+            if(prop.value == 1){
+              sprite = TileModelSprite(
+                path:'tile_sand.png',
+              );
+            }
+            return TileModel(
+                x: prop.position.x,
+                y: prop.position.y,
+                sprite: sprite,
+                // color: Colors.blue, // 색상만 사용할 수도 있습니다.
+            );
+        },
+      ),
+    );
+```
+
+'builder'에서는 속성과 함께 'TileModel'을 반환하는 지도의 각 '타일'을 생성할 수 있습니다.
+
+### TerrainBuilder 사용
+
+이 기능을 사용하려면 다음 패턴을 사용하는 타일 모서리의 SpriteSheet가 필요합니다.
+
+이 SpriteSheet는 타일 모래와 잔디입니다.
+
+![](../../_media/earth_to_grass.png)
+
+이 SpriteSheet는 타일 모래와 물입니다.
+
+![](../../_media/earth_to_water.png)
+
+---
+
+이제 다음과 같이 타일 스프라이트와 타일 스프라이트 코너를 등록하면 됩니다.
+
+먼저 지형 빌더를 만듭니다.
+
+```dart
+
+final double TILE_WATER = 0;
+final double TILE_SAND = 1;
+final double TILE_GRASS = 2;
+
+final terrainBuilder = TerrainBuilder(
+    tileSize: 32,
+    terrainList: [
+        MapTerrain(
+            value: TILE_WATER,
+            sprites: [
+                TileModelSprite(
+                    path: 'tile_water.png',
+                    size: Vector2.all(16),
+                ),
+            ],
+        ),
+        MapTerrain(
+            value: TILE_SAND,
+            sprites: [
+                TileModelSprite(
+                    path: 'tile_sand.png',
+                    size: Vector2.all(16),
+                ),
+            ],
+        ),
+        MapTerrain(
+            value: TILE_GRASS,
+            sprites: [
+                TileModelSprite(
+                    path: 'tile_grass.png',
+                    size: Vector2.all(16),
+                ),
+            ],
+        ),
+        MapTerrainCorners(
+            value: TILE_SAND,
+            to: TILE_WATER,
+            spriteSheet: TerrainSpriteSheet.create(
+            path: 'sand_to_water.png',
+            tileSize: Vector2.all(16),
+            ),
+        ),
+        MapTerrainCorners(
+            value: TILE_SAND,
+            to: TILE_GRASS,
+            spriteSheet: TerrainSpriteSheet.create(
+            path: 'sand_to_grass.png',
+            tileSize: Vector2.all(16),
+            ),
+        ),
+    ],
+);
+
+```
+
+그런 다음 `terrainBuilder`의 'build' 메소드를 `builder`에 전달합니다.
+
+```dart
+
+return BonfireWidget(
+      map: MatrixMapGenerator.generate(
+        axisInverted: true, // 행렬에 표시된 것과 동일한 지도를 생성하는 것은 'true'입니다. 법선 축은 `matrix[x][y]`이므로 `axisInverted`가 `true`이면 `matrix[y][x]`가 됩니다.
+        matrix: [
+          [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
+          [0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 0, 0, 0, 0],
+          [0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0],
+          [0, 0, 0, 0, 1, 1, 1, 2, 1, 1, 0, 0, 0, 0],
+          [0, 0, 0, 0, 1, 1, 2, 2, 1, 1, 0, 0, 0, 0],
+          [0, 0, 0, 0, 1, 1, 2, 2, 1, 1, 0, 0, 0, 0],
+          [0, 0, 0, 0, 1, 1, 2, 1, 1, 1, 0, 0, 0, 0],
+          [0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0],
+          [0, 0, 0, 0, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0],
+          [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
+          [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
+        ],
+        builder: terrainBuilder.build,
+      ),
+    );
+```
+
+그리고 결과는 다음과 같습니다.
+
+![](../../_media/random_map_example.png)
+
+
+### 지도 지형
+
+'MapTerrain'은 지도에 표시할 수 있는 각 유형의 지형입니다.
+기본 유형은 다음과 같습니다.
+
+- MapTerrain: 모서리가 없을 때의 기본 지형입니다.
+- MapTerrainCorners: 코너를 처리하는 지형입니다.
+
+##### MapTerrain
+
+```dart
+
+MapTerrain(
+    value: TILE_WATER, /// 지형이어야 하는 행렬의 숫자
+    type: 'water',
+    collisions: [],
+    properties: Map<String, dynamic>(),
+    spritesProportion: [0.6,0.4],
+    sprites: [  /// 이 유형에는 많은 스프라이트를 전달할 수 있으므로 배열이 필요합니다. `spritesProportion`을 구성하여 각각의 발생 비율을 구성합니다.
+        TileModelSprite(
+            path: 'tile_water.png',
+            size: Vector2.all(16),
+        ),
+        TileModelSprite(
+            path: 'tile_water_2.png',
+            size: Vector2.all(16),
+        ),
+    ],
+
+),
+
+```
+
+##### MapTerrainCorners
+
+```dart
+MapTerrainCorners(
+    value: TILE_SAND, // 출발지점
+    to: TILE_WATER, // 목적지점
+    type: 'water',
+    collisions: [],
+    properties: Map<String, dynamic>(),
+    spriteSheet: TerrainSpriteSheet.create(
+        path: 'sand_to_water.png',
+        tileSize: Vector2.all(16), // 이미지의 타일 크기
+    ),
+)
+
+```
+
+## 커스텀
+
+`WordMap`을 확장하는 클래스를 생성하고 `List<TileModel> 타일`을 채울 수 있는 자신만의 지도를 만들 수 있습니다. 이렇게 하면 지도를 그리는 데 사용되는 QuadTree 알고리즘을 재사용할 수 있습니다.
+또는 `GameMap`을 확장하여 자신만의 지도를 만드는 베이스를 사용할 수도 있습니다.
diff --git a/v3.0-kr/doc/mixins.md b/v3.0-kr/doc/mixins.md
new file mode 100644
index 0000000..f7d29d1
--- /dev/null
+++ b/v3.0-kr/doc/mixins.md
@@ -0,0 +1,402 @@
+# 믹스인
+
+> 믹스인을 사용하면 component 에 다양한 동작을 추가할 수 있습니다.
+
+
+아래에서는 현재 사용 가능한 주요 믹스인 트리를 볼 수 있습니다::
+
+<img src="_media/mixin_diagram.png"></img>
+
+
+## Movement
+
+움직임 추가를 담당하는 믹스인입니다.
+
+component 는 다음과 같은 속성을 얻습니다.
+
+```dart
+    double speed = 100;
+    Direction lastDirection = Direction.right;
+    Direction lastDirectionHorizontal = Direction.right;
+    Direction lastDirectionVertical = Direction.down;
+```
+
+그리고 component 를 이동하는 방법. (이러한 움직임은 충돌을 고려합니다. 'true'를 반환하면 움직임이 성공한 것입니다.)
+
+```dart
+    void moveUp({double? speed})
+    void moveDown({double? speed})
+    void moveLeft({double? speed})
+    void moveRight({double? speed})
+    void moveUpRight({double? speed})
+    void moveUpLeft({double? speed})
+    void moveDownLeft({double? speed})
+    void moveDownRight({double? speed})
+    void moveFromAngle({double? speed})
+    void stopMove({bool forceIdle = false, bool isX = true, bool isY = true})
+    void moveFromAngle(double angle, {double? speed})
+    void moveFromDirection(Direction direction, {bool enabledDiagonal = true})
+    bool moveToPosition(Vector2 position, {double? speed,bool useCenter = true})
+```
+
+움직임이 변하는 것을 listen 할 수 있습니다:
+
+```dart
+@override
+void onMove(
+    double speed,
+    Vector2 displacement,
+    Direction direction,
+    double angle,
+  ) {}
+
+```
+
+## DirectionAnimation
+
+> 이 믹스인을 사용하려면 구성 요소에 `Movement` 믹스인이 포함되어 있어야 합니다.
+
+움직임에 애니메이션을 추가하는 역할을 담당하는 믹스인입니다.
+
+SimpleDirectionAnimation을 설정해야 합니다.
+
+```dart
+class MyComponent extends GameComponent with Movement, DirectionAnimation{
+    MyComponent(){
+        animation = SimpleDirectionAnimation();
+    }
+}
+```
+
+다음을 사용하여 `SimpleDirectionAnimation`을 바꿀 수 있습니다.
+
+```dart
+
+Future<void> replaceAnimation(
+    SimpleDirectionAnimation newAnimation, {
+    bool doIdle = true,
+})
+
+```
+
+`SimpleDirectionAnimation`에는 애니메이션을 제어하는 데 사용할 수 있는 몇 가지 메소드가 있습니다.
+
+```dart
+
+/// Method used to play animation once time
+animation.playOnce(
+    FutureOr<SpriteAnimation> animation, {
+    VoidCallback? onFinish,
+    VoidCallback? onStart,
+    bool runToTheEnd = false,
+    bool flipX = false,
+    bool flipY = false,
+    bool useCompFlip = false,
+    Vector2? size,
+    Vector2? offset,
+  );
+
+/// `others`에 등록된 특정 애니메이션을 재생하는 데 사용되는 메서드
+animation.playOther(String key, {bool flipX = false, bool flipY = false});
+
+/// 다른 애니메이션에 새로운 애니메이션을 등록하는 데 사용되는 메소드
+animation.addOtherAnimation(
+    String key,
+    FutureOr<SpriteAnimation> animation,
+);
+
+animation.pause();
+
+animation.resume();
+
+```
+
+## MoveToPositionAlongThePath
+
+> 이 믹스인을 사용하려면 구성 요소에 `Movement` 믹스인이 포함되어 있어야 합니다.
+
+`a_star_algorithm`을 사용하여 경로를 찾고 경로를 통해 component 를 이동하는 역할을 담당하는 믹스인입니다.
+
+[경로 찾기](path_finding)를 참조하세요.
+
+## AutomaticRandomMovement
+
+> 이 믹스인을 사용하려면 component 에 `Movement` 믹스인이 포함되어 있어야 합니다.
+
+장면을 통과하는 적과 같은 무작위 움직임을 추가하는 역할을 담당하는 믹스인입니다.
+
+사용하려면 업데이트에 `runRandomMovement` 메소드를 추가하면 됩니다.
+
+```dart
+
+class MyComponent extends GameComponent with Movement, AutomaticRandomMovement{
+    
+    @override
+    void update(double dt) {
+        this.runRandomMovement(dt);
+        super.update(dt);
+    }
+}
+
+```
+
+모든 매개변수:
+
+```dart
+
+void runRandomMovement(
+    double dt, {
+    bool runOnlyVisibleInCamera = true,
+    double? speed,
+    int maxDistance = 50,
+    int minDistance = 25,
+
+    /// milliseconds
+    int timeKeepStopped = 2000,
+    bool updateAngle = false,
+    bool checkPositionWithRaycast = false,
+    RandomMovementDirectionEnum direction = RandomMovementDirectionEnum.all,
+    Function(Vector2 target)? onStartMove,
+    Function()? onArrivedTarget,
+  })
+
+```
+
+## MovementByJoystick
+
+> 이 믹스인을 사용하려면 component 에 'Movement' 및 'JoystickListener' 믹스인이 포함되어 있어야 합니다.
+
+조이스틱 이벤트를 통해 움직임을 추가하는 역할을 담당하는 믹스인입니다.
+
+```dart
+class MyComponent extends GameComponent with Movement, JoystickListener, MovementByJoystick{
+    
+}
+
+```
+
+이렇게 하면 이 component 를 조이스틱 관찰자로 추가하면 조이스틱과 상호 작용할 때 이동하게 됩니다.
+
+```dart
+
+    MyComponent myComp = MyComponent();
+    gameRef.joystickController?.addObserver(myComp);
+    gameRef.camera.moveToTargetAnimated(myComp);
+
+```
+
+'movementByJoystickEnabled'를 false로 설정하여 이 동작을 비활성화할 수 있습니다.
+
+## Attackable
+
+> 사용방법: `Player`, `Ally`, `Enemy`
+
+component 에 손상을 입는 동작을 추가하는 역할을 담당하는 믹스인입니다.
+
+component 는 다음과 같은 속성을 얻습니다.
+
+```dart
+    double maxLife;
+    bool isDead;
+    double life;
+```
+
+component 에 다음 메서드를 추가합니다.
+
+```dart
+    void initialLife(double life)
+    void addLife(double life)
+    void updateLife(double life,{bool verifyDieOrRevive = true})
+    void removeLife(double life)
+
+    /// 이 방법은 이 component 가 공격자로부터 피해를 받을 수 있는지 확인하는 데 사용됩니다.
+    @override
+    bool checkCanReceiveDamage(
+        AttackFromEnum attacker,
+        double damage,
+        dynamic from,
+    )
+    
+    /// 이 component 가 공격을 받는지 들을 수 있습니다.
+    @override
+    void receiveDamage(double damage, dynamic from)
+
+    /// 수명이 0보다 작은 경우 이 메서드가 호출됩니다.
+    @override
+    void die()
+```
+
+## Vision
+
+component 에 비전을 추가하는 역할을 담당하는 믹스인입니다. `Player`, `Npc`, `Decoration`과 같은 component 는 이 믹스인을 사용합니다.
+component 는 `seeComponent` 및 `seeComponentType` 메서드를 얻습니다.
+
+다음과 같이 구성 요소 비전을 그릴 수 있습니다.
+
+```dart
+    setupVision(
+        {
+            Color? color,
+            bool drawVision = false,
+            int countPolygonPoints = 20,
+        }
+    );
+```
+
+`seeComponent` 또는 `seeComponentType`과 같은 메소드를 사용하면 비전이 그려집니다.
+
+## Sensor
+
+위의 다른 객체를 감지하기 위해 트리거를 추가하는 역할을 담당하는 믹스인입니다.
+
+[센서](센서)를 참조하세요.
+
+## Lighting
+
+component 의 조명을 구성하는 데 사용되는 믹스인입니다.
+
+[조명](조명) 참조
+
+## BlockMovementCollision
+
+충돌이 발생하면 움직임을 멈추는 역할을 담당하는 믹스인입니다.
+
+[객체 충돌](collision_system)을 참조하세요.
+
+## Pushable
+> 이 믹스인을 사용하려면 component 에 `Movement` 믹스인이 포함되어 있어야 합니다.
+
+component 의 푸시 활성화를 담당하는 Mixin입니다.
+
+`bool onPush(GameComponent 컴포넌트)` 메소드를 재정의하여 언제 푸시할 수 있는지 제어할 수 있습니다. component 가 푸시 가능하면 true를 반환하고, 그렇지 않으면 false를 반환합니다. (기본값은 true를 반환합니다).
+
+## Follower
+
+이 믹스인은 component 가 대상의 위치를 따르도록 합니다.
+component 는 'followerTarget' 및 'followerOffset' 속성을 얻습니다.
+다음과 같이 대상을 구성할 수 있습니다.
+
+```dart
+
+setupFollower(target: myPLayer, offset: Vector2());
+
+```
+
+이 믹스인이 포함된 component 가 다른 component 의 하위로 추가된 경우입니다. 그는 부모의 입장을 따를 것입니다.
+
+
+## UseAssetsLoader
+
+자산을 로드하는 데 사용되는 믹스인:
+
+```dart
+class MyComponent extends GameComponent with UseAssetsLoader{
+    SpriteAnimation animation;
+    MyComponent(Vector2 position,Future<SpriteAnimation> animIdle){
+        this.position = position;
+        loader?.add(AssetToLoad(animIdle, (value) {
+            animation = value;
+        }));
+    }
+}
+```
+
+## UseSpriteAnimation
+
+SpriteAnimation의 사용을 더 쉬운 방법으로 component 에 추가하는 믹스인입니다.
+귀하의 component 는 'animation' 속성과 'playSpriteAnimationOnce' 메서드를 얻습니다.
+
+```dart
+
+class MyComponent extends GameComponent with UseSpriteAnimation{
+    MyComponent(Vector2 position){
+        this.position = position;
+    }
+
+    void playJump(){
+        playSpriteAnimationOnce(MySpriteSheetLoader.getJumpAnimation());
+    }
+
+    @override
+    Future onLoad() async {
+        setAnimation(await MySpriteSheetLoader.geAnimation());
+        return super.onLoad();
+    }
+}
+
+```
+
+현재 인덱스 애니메이션이 마지막 프레임인지 알 수 있습니다.
+
+```dart
+  bool get isAnimationLastFrame
+  int get animationCurrentIndex
+  int get isPaused
+```
+
+## UseSprite
+
+Sprite 사용을 더 쉽게 component 에 추가하는 믹스인입니다.
+귀하의 component 는 `sprite`를 얻습니다.
+
+```dart
+
+class MyComponent extends GameComponent with UseSprite{
+    MyComponent(Vector2 position){
+        this.position = position;
+    }
+
+    @override
+    Future onLoad() async {
+        sprite = await MySpriteSheetLoader.geSrite();
+        return super.onLoad();
+    }
+}
+
+```
+
+### UseBarLife
+
+공격 가능한 component 에 BarLife를 추가하는 데 사용되는 믹스인입니다.
+'setupBarLife'라는 BarLife를 구성합니다.
+
+```dart
+
+void setupBarLife({
+    Vector2? size,
+    Color? backgroundColor,
+    Color? borderColor,
+    double borderWidth = 2,
+    double margin = 4,
+    List<Color>? colors,
+    BorderRadius? borderRadius,
+    BarLifePorition barLifePosition = BarLifePorition.top,
+    Vector2? offset,
+    Vector2? textOffset,
+    TextStyle? textStyle,
+    bool showLifeText = true,
+    BarLifeTextBuilder? barLifetextBuilder,
+  })
+
+```
+
+### TileRecognizer
+
+타일을 인식하는데 사용되는 Mixin은 아래와 같습니다.
+
+지도를 작성하는 데 사용되는 Tiled 프로그램에서 `클래스`를 설정하거나 사용자 정의 속성을 설정할 수 있습니다. 이 믹스인을 사용하면 component 위에 있는 '타일' 정보에 액세스할 수 있습니다.
+
+```dart
+
+/// 현재 맵 타일이 어떤 타입인지 확인하는 메소드
+ String? tileTypeBelow();
+ /// 현재 지도 타일이 어떤 유형인지 확인하는 메서드
+ List<String> tileTypeListBelow()
+ /// 맵 타일이 현재 어떤 속성을 가지고 있는지 확인하는 메서드
+ Map<String, dynamic>? tilePropertiesBelow()
+ /// 현재 목록 맵 타일의 속성이 무엇인지 확인하는 메서드
+ List<Map<String, dynamic>>? tilePropertiesListBelow()
+ /// 아래에 어떤 지도 타일이 있는지 확인하는 메서드
+ Iterable<Tile> tileListBelow()
+
+```
diff --git a/v3.0-kr/doc/overview.md b/v3.0-kr/doc/overview.md
new file mode 100644
index 0000000..a1b556a
--- /dev/null
+++ b/v3.0-kr/doc/overview.md
@@ -0,0 +1,131 @@
+# 시작하기 전에
+
+Bonfire는 기본적으로 매개변수를 전달하고 게임에 맞게 구성하는 위젯입니다.
+
+
+## BonfireWidget
+
+```dart
+  @override
+  Widget build(BuildContext context) {
+    return BonfireWidget(
+      map: WorldMapByTiled('tile/map.json'), // required
+      joystick: Joystick(), 
+      player: Knight(), // 플레이어가 생략되면 조이스틱 방향이 지도 보기를 제어하므로 지도를 만드는 과정에서 매우 유용합니다.
+      interface: KnightInterface(),
+      background: GameComponent(), // `GameComponent`에서 확장하여 자신만의 배경을 만들 수 있습니다(예: 시간차 사용).
+      backgroundColor: Colors.black,
+      debugMode: false, // true인 경우 components 그리드를 그립니다.
+      showCollisionArea: false, // true인 경우 요소의 충돌 영역을 그립니다.
+      collisionAreaColor: Colors.blue, // 충돌 영역 색상을 사용자 정의하고 싶다면 여기를 수정하세요.
+      lightingColorGame: Colors.black.withOpacity(0.4), // 게임에 일반 조명을 추가하려는 경우 여기를 수정하세요.
+      colorFilter: GameColorFilter(), // 게임에 컬러 필터를 추가하여 특별한 느낌을 줄 수 있습니다.
+      components: [], // 여기에서 필요한 GameComponent를 추가할 수 있습니다.
+      overlayBuilderMap: { // 여기에서 위젯을 추가하여 게임 인터페이스를 구축할 수 있습니다.
+        'barLife':(game)=> MyBarLifeWidget(),
+      },
+      initialActiveOverlays:['barLife'], // 여기에서는 게임을 시작할 때 `overlayBuilderMap`에 전달된 인터페이스가 표시될 수 있도록 정의합니다.
+      cameraConfig: CameraConfig(), // 여기서 게임 카메라를 구성할 수 있습니다. 줌, 속도 등을 설정할 수 있습니다.
+      globalForces: [] // 여기서 'HandleForces' 믹스인을 사용하는 모든 GameComponents에 영향을 미치는 가속도(Acceleration Force 2D), 저항(ResistenceForce2D) 또는 선형(LinearForce2D)과 같은 힘을 추가할 수 있습니다.
+      onReady: (game){} // 게임이 준비되면 호출합니다.
+      focusNode: FocusNode(),
+      autofocus:true,
+      mouseCursor:
+      progress: ProgressWidget() // 지도를 로드하는 동안 표시되는 진행 상황입니다.
+    );
+  }
+```
+
+### 게임 요소를 동적으로 추가하기
+
+게임에서 component 를 동적으로 추가해야 하는 경우. 모든 component 내에서 다음을 사용할 수 있습니다.
+
+```dart
+  gameRef.add(MyComponent())
+```
+
+또는 다음을 사용하여 하위 component 와 같은 다른 component 내에 component 를 추가할 수 있습니다.
+
+```dart
+  add(MyComponent())
+```
+
+---
+
+### Components 레이어
+
+Bonfire 는 아래 레이어 다이어그램에 따라 렌더링되는 여러 component 로 구성됩니다.
+
+<img src="_media/layers.png" width="600"/>
+
+우리는 지도를 시작으로 아래에서 위로 공부하면서 이 각 레이어를 이해하게 됩니다.
+
+## 배경
+
+> render_priority = 10
+
+배경을 나타내는 component 를 추가할 수 있습니다. 시간차 및 상호작용하는 배경을 만드는 데 유용합니다.
+
+## 지도
+
+> render_priority = 20
+
+게임이 진행되는 지도(또는 세계)를 나타냅니다.
+
+자세한 내용을 보려면 [여기](Map)를 클릭하세요.
+
+## 장식
+
+> render_priority = Dynamic ( 30 + Axis Y)
+
+풍경에 추가할 수 있는 모든 것. 예를 들어 플레이어와 상호 작용하는 데 사용할 수 있는 배럴이나 NPC도 있습니다.
+
+자세한 내용을 보려면 [여기](Decoration)를 클릭하세요.
+
+## 적
+
+> render_priority = Dynamic ( 30 + Axis Y)
+
+게임 내 적 캐릭터를 나타냅니다. 이 클래스의 인스턴스에는 원할 때마다 사용하고 구성할 수 있는 작업과 움직임이 있습니다. 동시에, 귀하의 필요에 맞는 방식으로 모든 동작과 움직임을 맞춤화할 수 있습니다.
+
+자세한 내용을 보려면 [여기](Enemy)을 클릭하세요.
+
+## 플레이어
+
+> render_priority = Dynamic (30 + Axis Y)
+
+게임에서 사용자가 조종하는 캐릭터를 나타냅니다. 이 클래스의 인스턴스에는 사용 및 구성할 준비가 된 동작과 움직임이 있습니다.
+
+자세한 내용을 보려면 [여기](Player)를 클릭하세요.
+
+## 개체
+
+> render_priority = Dynamic (30 +  Axis Y)
+
+이 레이어에는 사용자 정의 `GameComponent`와 같이 게임에 추가된 모든 'GameComponent' 또는 `AnimatedGameObject`와 같이 이미 사용할 수 있는 유틸리티 개체가 포함됩니다.
+
+자세한 내용을 보려면 [여기](Objects)를 클릭하세요.
+
+## 빛 효과
+
+> render_priority = (highestPriority + 10)
+
+게임에 조명을 추가하는 역할을 담당하는 레이어입니다.
+
+자세한 내용은 [여기](lighting)를 클릭하세요.
+
+## 게임 인터페이스
+
+> render_priority = (highestPriority + 30)
+
+라이프 바, 체력, 설정 등을 그릴 수 있는 방법입니다. 즉, 게임 인터페이스에 추가할 수 있는 모든 것입니다.
+
+자세한 내용을 보려면 [여기](game_interface)를 클릭하세요.
+
+## 조이스틱
+
+> render_priority = highestPriority + 40
+
+플레이어를 제어하는 구성요소입니다.
+
+자세한 내용을 보려면 [여기](joystick)을 클릭하세요.
diff --git a/v3.0-kr/doc/path_finding.md b/v3.0-kr/doc/path_finding.md
new file mode 100644
index 0000000..8558108
--- /dev/null
+++ b/v3.0-kr/doc/path_finding.md
@@ -0,0 +1,50 @@
+# 경로 찾기
+
+> 장애물을 피해 길을 찾는 알고리즘
+
+<img src="_media/git_move_along_the_path.gif" width="600"/>
+
+Bonfire는 [a_star_algorithm](https://pub.dev/packages/a_star_algorithm) 패키지를 사용하여 경로를 찾습니다.
+
+
+사용하려면 Mixin `PathFinding`을 추가하고 `moveToPositionWithPathFinding` 메소드를 호출하기만 하면 됩니다(업데이트 메소드에서 이 메소드를 절대 사용하지 마십시오. 시작하려면 한 번만 수행하십시오).
+이 작업을 수행하려면 구성 요소에 믹스인 'Movement'(기본적으로 'Player' 및 'Enemy'가 사용함)가 포함되어 있어야 합니다.
+
+## 구성
+
+`setupMoveToPositionAlongThePath` 메소드를 호출하여 PathFinding을 구성할 수 있습니다. 아래를 참조하세요:
+
+```dart
+
+class Kinght extends SimplePlayer with PathFinding, TapGesture{
+
+    Kinght(Vector2 position)
+    : super(
+        ...
+    );
+
+    @override
+    void onTap() {}
+
+    @override
+    void onTapDownScreen(GestureEvent event) {
+        moveToPositionWithPathFinding(event.worldPosition);
+        super.onTapDownScreen(event);
+    }
+}
+
+```
+
+`setupPathFinding` 메소드를 사용하여 설정을 수행할 수 있습니다.
+
+``` dart
+
+setupPathFinding(
+    pathLineColor: Colors.lightBlueAccent.withOpacity(0.5),
+    barriersCalculatedColor: Colors.blue.withOpacity(0.5),
+    pathLineStrokeWidth: 4,
+    showBarriersCalculated: false, // 이것을 디버깅에 사용합니다. 이를 통해 알고리즘에 의해 충돌로 간주되는 타일을 지도에 표시할 수 있습니다.
+    tileSizeIsSizeCollision: false,
+)
+```
+
diff --git a/v3.0-kr/doc/player.md b/v3.0-kr/doc/player.md
new file mode 100644
index 0000000..24c15bc
--- /dev/null
+++ b/v3.0-kr/doc/player.md
@@ -0,0 +1,328 @@
+# 플레이어
+
+> <small>이것은 [GameComponent](https://github.com/RafaelBarbosatec/bonfire/blob/master/lib/base/game_comComponent.dart)이며 다음을 사용합니다. 
+[Movement](mixins?id=movement), 
+[Attackable](mixins?id=attackable), 
+[Vision](mixins?id=vision), 
+[MovementByJoystick](mixins?id=movementbyjoystick) and 
+[JoystickListener](joystick?id=joysticklistener)</small>
+
+게임에서 사용자가 조종하는 캐릭터를 나타냅니다. 이 클래스의 인스턴스에는 사용 및 구성할 준비가 된 동작과 움직임이 있습니다.
+'SimplePlayer', 'RotationPlayer', 'PlatformPlayer' 세 가지 유형의 적을 생성할 수 있습니다.
+
+## 기본 플레이어(SimplePlayer) 
+> <small>이는 [Player](#Player)이며 [DirectionAnimation](mixins?id=directionanimation)을 사용합니다.</small>
+
+
+45° 및 67.5° 원근에 사용됩니다. 그리고 모든 방향(위, 아래, 왼쪽, 오른쪽, 위쪽 오른쪽, 위쪽 왼쪽, 아래쪽 왼쪽, 아래쪽 오른쪽)에 대한 모션 애니메이션을 구성할 수 있습니다.
+
+이를 사용하려면 적을 나타내는 클래스를 만들고 SimplePlayer를 확장하면 됩니다.
+
+```dart
+
+class Kinght extends SimplePlayer {
+
+    Kinght(Vector2 position)
+      : super(
+          position: position, //required
+          size: Vector2(32.0,32.0), //required
+          life: 100,
+          speed: 100,
+          initDirection: Direction.right,
+          animation: SimpleDirectionAnimation(
+            idleLeft: Future<SpriteAnimation>(), 
+            idleRight: Future<SpriteAnimation>(), //required
+            runLeft: Future<SpriteAnimation>(), 
+            runRight: Future<SpriteAnimation>(), //required
+            idleUp: Future<SpriteAnimation>(),
+            idleDown: Future<SpriteAnimation>(),
+            idleUpLeft: Future<SpriteAnimation>(),
+            idleUpRight: Future<SpriteAnimation>(),
+            idleDownLeft: Future<SpriteAnimation>(),
+            idleDownRight: Future<SpriteAnimation>(),
+            runUp: Future<SpriteAnimation>(),
+            runDown: Future<SpriteAnimation>(),
+            runUpLeft: Future<SpriteAnimation>(),
+            runUpRight: Future<SpriteAnimation>(),
+            runDownLeft: Future<SpriteAnimation>(),
+            runDowntRight: Future<SpriteAnimation>(),
+          ), //required
+      );
+
+    @override
+    void update(double dt) {
+      // 필요한 로직을 작성하세요.
+      super.update(dt);
+    }
+
+    @override
+    void render(Canvas canvas) {
+      // 필요한 로직을 작성하세요.
+      super.render(canvas);
+    }
+
+    @override
+    void joystickChangeDirectional(JoystickDirectionalEvent event) {
+      // 조이스틱 이벤트로 필요한 로직을 작성하세요.
+      super.joystickChangeDirectional(event);
+    }
+
+    @override
+    void joystickAction(JoystickActionEvent event) {
+      // 조이스틱 이벤트로 필요한 로직을 작성하세요.
+      super.joystickAction(event);
+    }
+
+}
+
+```
+
+플레이어의 모든 움직임은 이미 조이스틱과 사용자의 상호 작용을 듣고 자동으로 수행됩니다.
+
+플레이어 인스턴스는 다음 메서드를 재정의하여 조이스틱에 구성된 작업을 수신할 수 있습니다.
+
+```dart
+
+  @override
+  void joystickAction(JoystickActionEvent event) {
+    // 조이스틱 이벤트로 필요한 로직을 작성하세요.
+    super.joystickAction(event);
+  }
+
+```
+
+
+조이스틱 동작이 수신되면 동작이 실행될 수 있습니다. 'Enemy'와 마찬가지로 여기에는 몇 가지 사전 포함된 작업이 있습니다.
+
+```dart
+
+// 플레이어에게 물리적 공격을 실행하여 설정된 빈도로 설정된 피해를 입힙니다. 이 공격을 나타내는 애니메이션을 추가할 수 있습니다.
+  void simpleAttackMelee(
+    {
+      Future<SpriteAnimation>? animationRight,
+      required double damage,
+      required Vector2 size,
+      dynamic id,
+      Direction? direction,
+      bool withPush = true,
+      double? sizePush,
+      Vector2? centerOffset,
+      double? marginFromCenter,
+      bool diagonalEnabled = true,
+    }
+  )
+  
+  // 원거리 공격을 실행합니다. 'FlyingAttackObject'를 게임에 추가하고 구성 방향으로 전송되며 충돌하는 사람에게 약간의 피해를 주거나 장벽(충돌 정의 타일)에 부딪힐 때 파괴됩니다.
+  void simpleAttackRange(
+    {
+      required Future<SpriteAnimation> animationRight,
+      required Vector2 size,
+      Future<SpriteAnimation>? animationDestroy,
+      Vector2? destroySize,
+      dynamic id,
+      double speed = 150,
+      double damage = 1,
+      Direction? direction,
+      bool withCollision = true,
+      bool diagonalEnabled = true,
+      VoidCallback? onDestroy,
+      ShapeHitbox? collision,
+      LightingConfig? lightingConfig,
+    }
+  )
+    
+    // 반경 내에서 적을 관찰합니다(radiusVision).
+    void seeEnemy(
+      {
+        required Function(List<Enemy>) observed,
+        VoidCallback? notObserved,
+        double radiusVision = 32,
+        double? angle, // 방향
+        double? visionAngle, // 기본값 6.28319(360도)
+      }
+    )
+
+```
+
+그리고 모든 `GameComponent' 메소드. [GameComponent 함수](#TODO) 살펴보기
+
+### 애니메이션 변경
+
+`SimplePlayer` 애니메이션을 업데이트하려면 다음 방법을 사용해야 합니다:
+
+```dart
+
+  replaceAnimation(SimpleDirectionAnimation());
+
+```
+
+순간 애니메이션을 재생하려면 'SimpleDirectionAnimation' 메서드를 사용해야 합니다. 예를 들어:
+
+```dart
+
+  animation.playOnce(
+    FutureOr<SpriteAnimation> animation, {
+    VoidCallback? onFinish,
+    VoidCallback? onStart,
+    bool runToTheEnd = false,
+    bool flipX = false,
+    bool flipY = false,
+    bool useCompFlip = false,
+    Vector2? size,
+    Vector2? offset,
+  );
+  animation.pause();
+  animation.resume();
+
+```
+
+## 회전 플레이어(RotationPlayer)
+
+> <small>이것은 [Player](#Player)이며 다음을 사용합니다.
+[스프라이트 애니메이션 사용](mixins?id=usespriteanimation),
+[자산 로더 사용](mixins?id=useassetsloader)</small>
+
+90° 원근에 사용됩니다. 그리고 실행 및 유휴에 대한 모션 애니메이션을 구성할 수 있습니다.
+
+```dart
+
+class PlayerTank extends RotationPlayer {
+
+    PlayerTank(vector2 position)
+      : super(
+        position: position, //required
+        animIdle: Future<SpriteAnimation>(), //required
+        animRun: Future<SpriteAnimation>(), //required
+        size: Vector.all(32), //required
+        life: 100,
+        speed: 100,
+        currentRadAngle: -1.55,
+      );
+}
+
+```
+
+조이스틱 동작이 수신되면 동작이 실행될 수 있습니다. 'Enemy'와 마찬가지로 여기에는 몇 가지 사전 포함된 작업이 있습니다.
+
+```dart
+
+// 플레이어에게 물리적 공격을 실행하여 설정된 빈도로 설정된 피해를 입힙니다. 이 공격을 나타내는 애니메이션을 추가할 수 있습니다.
+  void simpleAttackMelee(
+     {
+      required Future<SpriteAnimation> attackEffectTopAnim,
+      required double damage,
+      required Vector2 size,
+      int? id,
+      bool withPush = false,
+      double? radAngleDirection,
+      double marginFromCenter = 16,
+      Vector2? centerOffset,
+     }
+  )
+  
+  // 원거리 공격을 실행합니다. 'FlyingAttackObject'를 게임에 추가하고 구성 방향으로 전송되며 충돌하는 사람에게 약간의 피해를 주거나 장벽(충돌 정의 타일)에 부딪힐 때 파괴됩니다.
+  void simpleAttackRange(
+     {
+      required Future<SpriteAnimation> animation,
+      required Vector2 size,
+      Future<SpriteAnimation>? animationDestroy,
+      Vector2? destroySize,
+      dynamic id,
+      double speed = 150,
+      double damage = 1,
+      double? radAngleDirection,
+      bool withDecorationCollision = true,
+      VoidCallback? onDestroy,
+      ShapeHitbox? collision,
+      LightingConfig? lightingConfig,
+      Vector2? centerOffset,
+      double marginFromOrigin = 16,
+    }
+  )
+    
+    // 반경 내에서 적을 관찰합니다(radiusVision).
+    void seeEnemy(
+       {
+          required Function(List<Enemy>) observed,
+          VoidCallback? notObserved,
+          double radiusVision = 32,
+       }
+    )
+
+```
+
+### 애니메이션 변경
+
+`RotationPlayer`를 업데이트하려면 `animIdle` 및 `animRun` 변수를 업데이트하면 됩니다.
+
+## 플랫폼 플레이어(PlatformPlayer)
+
+> <small>이것은 [SimplePlayer](#SimplePlayer)이며 다음을 사용합니다.
+[블록 이동 충돌](#TODO),
+[점프](#TODO)
+및 [점프 애니메이션](#TODO)</small>
+
+Used for platform games. And we can configure Motion animations for run, idle and jump.
+
+```dart
+
+class MarioPlayer extends PlatformPlayer {
+
+    MarioPlayer(vector2 position)
+      : super(
+        position: position, //required
+        animation: PlatformAnimations(), //required
+        size: Vector.all(32), //required
+        life: 100,
+        speed: 100,
+        countJumps: 1,
+      );
+}
+
+```
+
+### 점프
+
+플레이어 점프를 수행하려면 [Jumper mixin](#TODO) 메서드를 사용할 수 있습니다.
+
+```dart
+  jump({double? jumpSpeed, bool force = false});
+
+```
+
+
+### 애니메이션 변경
+
+`PlatformPlayer` 애니메이션을 업데이트하려면 다음 방법을 사용해야 합니다:
+
+```dart
+
+  replacePlatformAnimation(PlatformAnimations());
+
+```
+
+순간 애니메이션을 재생하려면 'SimpleDirectionAnimation' 메서드를 사용해야 합니다. 예를 들어:
+
+```dart
+
+  animation.playOnce(
+    FutureOr<SpriteAnimation> animation, {
+    VoidCallback? onFinish,
+    VoidCallback? onStart,
+    bool runToTheEnd = false,
+    bool flipX = false,
+    bool flipY = false,
+    bool useCompFlip = false,
+    Vector2? size,
+    Vector2? offset,
+  );
+  animation.pause();
+  animation.resume();
+
+```
+
+> OBS: 올바른 동작을 위해서는 이 구성 요소에 중력을 추가한다는 것을 기억해야 합니다. [HandleForces](#TODO) 살펴보기
+
+## 커스텀
+
+이러한 유형의 플레이어 중 어느 것도 귀하의 요구 사항을 충족하지 못하는 경우. `Player` 클래스를 확장하여 자신만의 것을 만들 수 있습니다.
diff --git a/v3.0-kr/doc/scene_builder.md b/v3.0-kr/doc/scene_builder.md
new file mode 100644
index 0000000..9401879
--- /dev/null
+++ b/v3.0-kr/doc/scene_builder.md
@@ -0,0 +1,58 @@
+# 장면 만들기
+
+> 컷씬을 만드는데 사용됩니다.
+
+장면을 만들려면 `gameRef.startScene()`을 호출하세요.
+
+```dart
+
+final enemy = gameRef.enemies().first;
+gameRef.startScene(
+  [
+    CameraSceneAction.position(Vector2(800, 800)),
+    CameraSceneAction.target(gameRef.player!),
+    CameraSceneAction.target(enemy, zoom: 2),
+    DelaySceneAction(Duration(seconds: 1)),
+    MoveComponentSceneAction(
+      component: enemy,
+      newPosition: enemy.position.clone()..add(Vector2(-40, -10)),
+      speed: 20,
+    ),
+    CameraSceneAction.target(gameRef.player!, zoom: 1),
+  ],
+);
+
+```
+
+결과:
+
+<img src="../../_media/scene_example.gif" width="600"/>
+
+- 현재 장면을 중지하려면:
+
+```dart
+
+gameRef.stopScene();
+
+```
+
+- 상태 및 현재 `SceneAction`에 액세스하려면:
+
+```dart
+
+SceneBuilderStatus status = gameRef.sceneBuilderStatus;
+status.isRuning;
+status.currentAction;
+
+```
+
+## 동적인 장면 연출
+
+이미 생성된 기본 작업이 있습니다.
+
+- CameraSceneAction // 카메라를 위치로 이동하거나 대상을 따라가는 데 사용됩니다.
+- DelaySceneAction // 지연을 적용하는 데 사용됩니다.
+- MoveComponentSceneAction // 'Movement' 믹스인을 사용하는 구성요소를 이동하는 데 사용됩니다.
+- AwaitCallbackSceneAction // 무엇이든 하는 데 사용되며 완료되면 다음 작업으로 전달될 `completed` 함수를 호출하기만 하면 됩니다.
+
+클래스를 생성하고 `SceneAction`을 확장하여 자신만의 `SceneAction`을 만들 수 있습니다.
diff --git a/v3.0-kr/doc/sensor.md b/v3.0-kr/doc/sensor.md
new file mode 100644
index 0000000..aa21e9a
--- /dev/null
+++ b/v3.0-kr/doc/sensor.md
@@ -0,0 +1,39 @@
+# 센서
+
+> 믹스인은 물체가 접촉했지만 통로를 막지 않고 감지하는 데 유용합니다.
+예: 지상의 불, 스파이크 등 캐릭터나 적이 통과하여 피해를 입거나 다른 유형의 행동을 활성화할 수 있는 것입니다.
+
+<img src="../../_media/sensor.gif" width="600"/>
+
+```dart
+
+class Spikes extends GameDecoration with Sensor<Myplayer> {
+  MyCustomDecoration(Position position)
+      : super.withAnimation(
+          Future<SpriteAnimation>(),
+          size: Vector2.all(32),
+          position: position,
+        ){
+            // 센서 확인 접점 간격을 구성하려면 이 메서드를 호출합니다. 기본값은 100밀리초입니다.
+            setSensorInterval(100);
+        }
+
+    @override
+    void onContact(Myplayer component) {
+        // 접촉된 Myplayer로 필요한 로직을 작성합니다.
+        super.onContact(component);
+    }
+
+    void onContactExit(Myplayer component) {
+         // 접촉된 Myplayer로 필요한 로직을 작성합니다.
+         super.onContactExit(component);
+    }
+
+    @override
+    Future<void> onLoad() {
+        add(RectangleHitbox(size:size));
+        return super.onLoad();
+    }
+
+}
+```
diff --git a/v3.0-kr/doc/tiled_support.md b/v3.0-kr/doc/tiled_support.md
new file mode 100644
index 0000000..1603d2e
--- /dev/null
+++ b/v3.0-kr/doc/tiled_support.md
@@ -0,0 +1,76 @@
+# 타일
+> Tiled 버전 `1.9.0`에서 테스트되었습니다.
+
+[Video example](https://www.youtube.com/watch?v=hVCmLqZ0JVw)
+
+.json 확장자를 사용하여 Tiled로 구축된 지도를 지원합니다.
+
+- [x] 다중 타일 레이어
+- [x] 다중 ObjectLayer
+- [x] 타일세트
+- [x] 타일 애니메이션
+- [x] URL에서 지도 로드
+- [x] 텍스트
+- [x] 이미지 레이어
+
+충돌
+   - [x] 다중 충돌
+   - [x] 직사각형 충돌
+   - [x] 원 충돌
+   - [x] 다각형 충돌
+   - [ ] 점 충돌
+
+
+## 사용법
+
+기본 `assets/images/`에 따라 Tiled가 생성한 파일을 프로젝트에 추가합니다.
+
+```yaml
+flutter:
+  assets:
+    - assets/images/tiled/map.json
+    - assets/images/tiled/tile_set.json
+    - assets/images/tiled/img_tile_set.png
+```
+
+Tiled로 제작된 지도의 경우 위젯 'BonfireWidget'을 사용해야 합니다(예: [여기](https://bonfire-engine.github.io/#/get-started?id=creating-your-map)):
+
+```dart
+  WorldMapByTiled map = WorldMapByTiled(
+    'tiled/map.json', // 기본 파일 경로 또는 URL(예: http://rafaelbarbosatec.github.io/tiled/my_map.json)
+    forceTileSize: DungeonMap.tileSize, // 타일의 크기를 원본보다 크거나 작게 강제로 설정하려는 경우
+    objectsBuilder: {
+        'goblin': (TiledObjectProperties properties) => Goblin(properties.position),
+        'torch': (TiledObjectProperties properties) => Torch(properties.position),
+        'barrel': (TiledObjectProperties properties) => BarrelDraggable(properties.position,),
+    },
+  );
+
+  return BonfireWidget(
+    joystick: Joystick(
+      directional: JoystickDirectional()
+    ),
+    map: map,
+    lightingColorGame: Colors.black.withOpacity(0.5),
+  );
+```
+
+## 타일 맵 예시
+
+플레이어 위에 타일을 그리려면 타일 세트에 `above` 유형을 추가하세요.
+
+![](../../_media/print_exemplo_tiled.png)
+
+결과:
+
+![](../../_media/print_result_tiled.png)
+
+
+## 유용한 정보
+
+타일의 클래스를 `above`로 설정하여 게임의 모든 구성 요소 위에 이 타일을 렌더링할 수 있습니다.
+레이어의 모든 타일을 모든 구성 요소 위에 렌더링해야 하는 경우 레이어에 사용자 정의 속성을 만들고 값이 `above`인 클래스라는 속성을 만들 수 있습니다.
+
+타일의 클래스를 `dynamicAbove`로 설정하여 이 타일을 Y축을 기준으로 동적으로 렌더링할 수 있습니다.
+
+개체의 클래스를 `collision`로 설정할 수 있습니다. 이 개체는 투명도와 충돌을 통해 게임에 추가됩니다.
diff --git a/v3.0-kr/doc/util.md b/v3.0-kr/doc/util.md
new file mode 100644
index 0000000..07ab5f7
--- /dev/null
+++ b/v3.0-kr/doc/util.md
@@ -0,0 +1,154 @@
+# 유틸리티
+
+게임 개발 프로세스에 도움이 될 수 있는 몇 가지 기능과 component 가 있습니다.
+
+## Functions
+
+`BonfireUtil`에는 도움이 될 수 있는 많은 기능이 있습니다:
+
+```dart
+
+ Direction getDirectionFromAngle(double angle);
+ double getAngleFromDirection(Direction direction);
+ double angleBetweenPoints(Vector2 p1, Vector2 p2);
+ Offset rotatePoint(Offset point, double angle, Offset center);
+ Vector2 movePointByAngle(
+    Vector2 point,
+    double speed,
+    double angle,
+  );
+Vector2 vector2ByAngle(double angle, {double intencity = 1})
+
+```
+
+
+## Components
+
+
+### ComponentSpawner
+
+때로는 지도에 적이나 아이템과 같은 것을 동적으로 생성해야 하는 경우가 있습니다. 이를 수행하려면 `ComponentSpawner`를 사용할 수 있습니다:
+
+```dart
+
+    ComponentSpawner({
+        required Vector2 position,
+        required this.area,
+        required this.interval,
+        required this.builder,
+        this.spawCondition,
+        this.onlyVisible = true,
+    })
+
+
+```
+
+
+### GameObject
+
+'Sprite'를 렌더링하는 개체입니다.
+
+
+```dart
+ GameObject({
+    required Vector2 position,
+    required Vector2 size,
+    required FutureOr<Sprite>? sprite,
+    Vector2? positionFromTarget,
+    LightingConfig? lightingConfig,
+    this.objectPriority,
+    double angle = 0,
+    Anchor anchor = Anchor.topLeft,
+  })
+```
+
+### AnimatedGameObject
+
+`SpriteAnimation`을 렌더링하는 개체입니다.
+
+```dart
+   AnimatedGameObject({
+    required super.position,
+    required super.size,
+    FutureOr<SpriteAnimation>? animation,
+    this.onFinish,
+    this.onStart,
+    this.removeOnFinish = true,
+    super.angle = 0,
+    super.lightingConfig,
+    super.anchor = Anchor.topLeft,
+    bool loop = true,
+    super.objectPriority,
+  })
+
+```
+
+### FollowerGameObject
+
+
+이전 것과 마찬가지로 애니메이션이 스스로 파괴되기 전에 한 번 재생할 수 있으며 루프에서 계속 재생할 수도 있습니다. 그러나 가장 중요한 특징은 이 component 가 플레이어, 적 또는 장식과 같은 지도의 다른 요소를 따른다는 것입니다.
+
+
+```dart
+FollowerGameObject({
+    required GameComponent target,
+    required super.size,
+    required super.sprite,
+    Vector2? offset,
+    super.objectPriority,
+    super.lightingConfig,
+  })
+```
+
+### AnimatedFollowerObject
+
+애니메이션과 동일한 'FollowerObject'입니다.
+
+```dart
+AnimatedFollowerGameObject({
+    required super.animation,
+    required super.size,
+    required GameComponent target,
+    super.lightingConfig,
+    super.loop = true,
+    super.onFinish,
+    super.onStart,
+    super.angle,
+    super.removeOnFinish = true,
+    Vector2? offset,
+    super.objectPriority,
+  })
+```
+
+
+
+### FlyingAttackGameObject
+
+
+특정 방향으로 설정된 특정 속도로 구성되는 component 도 구성 가능하며 피해를 주는 적이나 플레이어에게만 타격을 가하거나 충돌이 있는 component(타일, 장식)에 타격을 가하면 파괴될 수 있습니다.
+
+이는 '각도' 또는 '방향'에서 이동합니다.
+
+```dart
+
+FlyingAttackGameObject({
+    required super.position,
+    required super.size,
+    required super.animation,
+    super.angle = 0,
+    this.direction,
+    this.id,
+    this.animationDestroy,
+    this.destroySize,
+    double speed = 150,
+    this.damage = 1,
+    this.attackFrom = AttackFromEnum.ENEMY,
+    this.withDecorationCollision = true,
+    this.onDestroy,
+    this.enabledDiagonal = true,
+    super.lightingConfig,
+    this.collision,
+  })
+
+```
+
diff --git a/v3.0/_navbar.md b/v3.0/_navbar.md
index e69de29..5b240d1 100644
--- a/v3.0/_navbar.md
+++ b/v3.0/_navbar.md
@@ -0,0 +1,7 @@
+- <div class="nav-dropdown-container">
+      <a>Languages</a>
+      <div class="nav-dropdown">
+          <a href="/bonfire-engine.github.io/index.html#">English</a>
+          <a href="/bonfire-engine.github.io/index-kr.html#">한국어</a>
+      </div>
+  </div>
