Introduce Character

This commit is huge breaking change.
The Entity class has been downgraded to some generic object which can be pushed onto the ObjectLayer, whereas the former "entity" concept has been replaced with Character class.

api/src/main/java/com/bartlomiejpluta/base/api/ai/NPC.java

@@ -1,7 +1,7 @@
 package com.bartlomiejpluta.base.api.ai;
 
-import com.bartlomiejpluta.base.api.entity.Entity;
+import com.bartlomiejpluta.base.api.character.Character;
 
-public interface NPC extends Entity {
+public interface NPC extends Character {
    AI getStrategy();
 }

api/src/main/java/com/bartlomiejpluta/base/api/character/Character.java

@@ -0,0 +1,26 @@
+package com.bartlomiejpluta.base.api.character;
+
+import com.bartlomiejpluta.base.api.animation.Animated;
+import com.bartlomiejpluta.base.api.entity.Entity;
+import com.bartlomiejpluta.base.api.event.Event;
+import com.bartlomiejpluta.base.api.event.EventType;
+import com.bartlomiejpluta.base.api.move.Direction;
+import com.bartlomiejpluta.base.api.move.Movable;
+
+import java.util.concurrent.CompletableFuture;
+import java.util.function.Consumer;
+
+public interface Character extends Movable, Animated, Entity {
+
+   Direction getFaceDirection();
+
+   void setFaceDirection(Direction direction);
+
+   void changeCharacterSet(String characterSetUid);
+
+   CompletableFuture<Void> performInstantAnimation();
+
+   <E extends Event> void addEventListener(EventType<E> type, Consumer<E> listener);
+
+   <E extends Event> void removeEventListener(EventType<E> type, Consumer<E> listener);
+}

api/src/main/java/com/bartlomiejpluta/base/api/context/Context.java

@@ -3,7 +3,7 @@ package com.bartlomiejpluta.base.api.context;
 import com.bartlomiejpluta.base.api.animation.Animation;
 import com.bartlomiejpluta.base.api.audio.Sound;
 import com.bartlomiejpluta.base.api.camera.Camera;
-import com.bartlomiejpluta.base.api.entity.Entity;
+import com.bartlomiejpluta.base.api.character.Character;
 import com.bartlomiejpluta.base.api.event.Event;
 import com.bartlomiejpluta.base.api.event.EventType;
 import com.bartlomiejpluta.base.api.gui.GUI;
@@ -39,7 +39,7 @@ public interface Context extends Updatable, Renderable, Disposable {
 
    void closeMap();
 
-   Entity createEntity(String entitySetUid);
+   Character createCharacter(String characterSetUid);
 
    Animation createAnimation(String animationUid);
 

api/src/main/java/com/bartlomiejpluta/base/api/entity/Entity.java

@@ -1,49 +1,23 @@
 package com.bartlomiejpluta.base.api.entity;
 
-import com.bartlomiejpluta.base.api.animation.Animated;
-import com.bartlomiejpluta.base.api.event.Event;
-import com.bartlomiejpluta.base.api.event.EventType;
 import com.bartlomiejpluta.base.api.event.Reactive;
+import com.bartlomiejpluta.base.api.location.Locationable;
 import com.bartlomiejpluta.base.api.map.layer.object.ObjectLayer;
-import com.bartlomiejpluta.base.api.move.Direction;
-import com.bartlomiejpluta.base.api.move.Movable;
 import com.bartlomiejpluta.base.internal.logic.Updatable;
 import com.bartlomiejpluta.base.internal.render.Renderable;
 
-import java.util.concurrent.CompletableFuture;
-import java.util.function.Consumer;
+public interface Entity extends Locationable, Renderable, Updatable, Reactive {
+   boolean isBlocking();
 
-public interface Entity extends Reactive, Movable, Animated, Renderable, Updatable {
+   void setBlocking(boolean blocking);
 
-   Direction getFaceDirection();
+   int getZIndex();
 
-   void setFaceDirection(Direction direction);
-
-   int chebyshevDistance(Entity other);
-
-   int manhattanDistance(Entity other);
-
-   Direction getDirectionTowards(Entity target);
+   void setZIndex(int zIndex);
 
    ObjectLayer getLayer();
 
    void onAdd(ObjectLayer layer);
 
    void onRemove(ObjectLayer layer);
-
-   boolean isBlocking();
-
-   void setBlocking(boolean blocking);
-
-   void changeEntitySet(String entitySetUid);
-
-   int getZIndex();
-
-   void setZIndex(int zIndex);
-
-   CompletableFuture<Void> performInstantAnimation();
-
-   <E extends Event> void addEventListener(EventType<E> type, Consumer<E> listener);
-
-   <E extends Event> void removeEventListener(EventType<E> type, Consumer<E> listener);
 }

api/src/main/java/com/bartlomiejpluta/base/api/location/Locationable.java

@@ -1,5 +1,6 @@
 package com.bartlomiejpluta.base.api.location;
 
+import com.bartlomiejpluta.base.api.move.Direction;
 import com.bartlomiejpluta.base.internal.object.Placeable;
 import org.joml.Vector2fc;
 import org.joml.Vector2ic;
@@ -19,7 +20,13 @@ public interface Locationable extends Placeable {
 
    void setPositionOffset(float offsetX, float offsetY);
 
+   Direction getDirectionTowards(Locationable target);
+
    int chebyshevDistance(Vector2ic coordinates);
 
    int manhattanDistance(Vector2ic coordinates);
+
+   int chebyshevDistance(Locationable other);
+
+   int manhattanDistance(Locationable other);
 }

api/src/main/java/com/bartlomiejpluta/base/api/move/CharacterMovement.java

@@ -1,6 +1,6 @@
 package com.bartlomiejpluta.base.api.move;
 
-import com.bartlomiejpluta.base.api.entity.Entity;
+import com.bartlomiejpluta.base.api.character.Character;
 import lombok.EqualsAndHashCode;
 import lombok.Getter;
 import lombok.NonNull;
@@ -9,13 +9,13 @@ import org.joml.Vector2ic;
 
 @Getter
 @EqualsAndHashCode
-public final class EntityMovement implements Movement {
-   private final Entity object;
+public final class CharacterMovement implements Movement {
+   private final Character object;
    private final Direction direction;
    private final Vector2ic from;
    private final Vector2ic to;
 
-   public EntityMovement(@NonNull Entity object, @NonNull Direction direction) {
+   public CharacterMovement(@NonNull Character object, @NonNull Direction direction) {
       this.object = object;
       this.direction = direction;
 

api/src/main/java/com/bartlomiejpluta/base/lib/ai/FollowObjectAI.java

@@ -2,7 +2,7 @@ package com.bartlomiejpluta.base.lib.ai;
 
 import com.bartlomiejpluta.base.api.ai.AI;
 import com.bartlomiejpluta.base.api.ai.NPC;
-import com.bartlomiejpluta.base.api.entity.Entity;
+import com.bartlomiejpluta.base.api.location.Locationable;
 import com.bartlomiejpluta.base.api.map.layer.object.ObjectLayer;
 import com.bartlomiejpluta.base.api.move.MoveEvent;
 import com.bartlomiejpluta.base.util.path.MovementPath;
@@ -11,7 +11,7 @@ import com.bartlomiejpluta.base.util.pathfinder.PathFinder;
 import lombok.NonNull;
 import lombok.Setter;
 
-public abstract class FollowEntityAI<N extends NPC, T extends Entity> implements AI {
+public abstract class FollowObjectAI<N extends NPC, T extends Locationable> implements AI {
 
    private final PathFinder finder;
    private final PathExecutor<N> executor;
@@ -22,7 +22,7 @@ public abstract class FollowEntityAI<N extends NPC, T extends Entity> implements
 
    private MovementPath<N> path = null;
 
-   protected FollowEntityAI(@NonNull PathFinder finder, @NonNull N npc, @NonNull T target) {
+   protected FollowObjectAI(@NonNull PathFinder finder, @NonNull N npc, @NonNull T target) {
       this.finder = finder;
       this.npc = npc;
       this.target = target;
@@ -37,7 +37,7 @@ public abstract class FollowEntityAI<N extends NPC, T extends Entity> implements
       var movable = event.getMovable();
 
       // Refresh only when target has been displaced
-      // or another entity is blocking current path
+      // or another object is blocking current path
       if (movable == target || (path != null && path.contains(movable))) {
          path = null;
       }

api/src/main/java/com/bartlomiejpluta/base/lib/ai/KeepStraightDistanceAI.java

@@ -2,7 +2,7 @@ package com.bartlomiejpluta.base.lib.ai;
 
 import com.bartlomiejpluta.base.api.ai.AI;
 import com.bartlomiejpluta.base.api.ai.NPC;
-import com.bartlomiejpluta.base.api.entity.Entity;
+import com.bartlomiejpluta.base.api.location.Locationable;
 import com.bartlomiejpluta.base.api.map.layer.object.ObjectLayer;
 import com.bartlomiejpluta.base.api.move.MoveEvent;
 import com.bartlomiejpluta.base.util.path.MovementPath;
@@ -15,7 +15,7 @@ import org.joml.Vector2ic;
 
 import java.util.ArrayList;
 
-public abstract class KeepStraightDistanceAI<N extends NPC, T extends Entity> implements AI {
+public abstract class KeepStraightDistanceAI<N extends NPC, T extends Locationable> implements AI {
    private final N npc;
    @Setter(onParam = @__(@NonNull))
    private T target;
@@ -44,7 +44,7 @@ public abstract class KeepStraightDistanceAI<N extends NPC, T extends Entity> im
       var movable = event.getMovable();
 
       // Refresh only when target has been displaced
-      // or another entity is blocking current path
+      // or another object is blocking current path
       if (movable == target || (path != null && path.contains(movable))) {
          path = null;
       }

api/src/main/java/com/bartlomiejpluta/base/lib/ai/RunawayAI.java

@@ -2,7 +2,7 @@ package com.bartlomiejpluta.base.lib.ai;
 
 import com.bartlomiejpluta.base.api.ai.AI;
 import com.bartlomiejpluta.base.api.ai.NPC;
-import com.bartlomiejpluta.base.api.entity.Entity;
+import com.bartlomiejpluta.base.api.location.Locationable;
 import com.bartlomiejpluta.base.api.map.layer.object.ObjectLayer;
 import com.bartlomiejpluta.base.api.move.Direction;
 import lombok.AllArgsConstructor;
@@ -12,7 +12,7 @@ import lombok.Setter;
 import java.util.Random;
 
 @AllArgsConstructor
-public class RunawayAI<N extends NPC, T extends Entity> implements AI {
+public class RunawayAI<N extends NPC, T extends Locationable> implements AI {
    @NonNull
    private final N npc;
 

api/src/main/java/com/bartlomiejpluta/base/lib/animation/AnimationDelegate.java

@@ -2,6 +2,7 @@ package com.bartlomiejpluta.base.lib.animation;
 
 import com.bartlomiejpluta.base.api.animation.Animation;
 import com.bartlomiejpluta.base.api.camera.Camera;
+import com.bartlomiejpluta.base.api.location.Locationable;
 import com.bartlomiejpluta.base.api.map.layer.base.Layer;
 import com.bartlomiejpluta.base.api.move.AnimationMovement;
 import com.bartlomiejpluta.base.api.move.Direction;
@@ -196,6 +197,11 @@ public abstract class AnimationDelegate implements Animation {
       return animation.isMoving();
    }
 
+   @Override
+   public Direction getDirectionTowards(Locationable target) {
+      return animation.getDirectionTowards(target);
+   }
+
    @Override
    public int chebyshevDistance(Vector2ic coordinates) {
       return animation.chebyshevDistance(coordinates);
@@ -206,6 +212,16 @@ public abstract class AnimationDelegate implements Animation {
       return animation.manhattanDistance(coordinates);
    }
 
+   @Override
+   public int chebyshevDistance(Locationable other) {
+      return animation.chebyshevDistance(other);
+   }
+
+   @Override
+   public int manhattanDistance(Locationable other) {
+      return animation.manhattanDistance(other);
+   }
+
    @Override
    public Vector2fc getPositionOffset() {
       return animation.getPositionOffset();

api/src/main/java/com/bartlomiejpluta/base/lib/animation/BulletAnimationRunner.java

@@ -179,7 +179,7 @@ public class BulletAnimationRunner implements AnimationRunner {
             var target = getCoordinates().add(direction.vector, new Vector2i());
             if (layer instanceof ObjectLayer) {
                for (var entity : ((ObjectLayer) layer).getEntities()) {
-                  var movement = entity.getMovement();
+                  var movement = (entity instanceof Movable) ? ((Movable) entity).getMovement() : null;
                   if ((entity.getCoordinates().equals(target) || movement != null && movement.getTo().equals(target)) && entity.isBlocking()) {
                      onHit.accept(movable, entity);
                      return;

api/src/main/java/com/bartlomiejpluta/base/lib/character/CharacterDelegate.java

@@ -1,12 +1,13 @@
-package com.bartlomiejpluta.base.lib.entity;
+package com.bartlomiejpluta.base.lib.character;
 
 import com.bartlomiejpluta.base.api.camera.Camera;
-import com.bartlomiejpluta.base.api.entity.Entity;
+import com.bartlomiejpluta.base.api.character.Character;
 import com.bartlomiejpluta.base.api.event.Event;
 import com.bartlomiejpluta.base.api.event.EventType;
+import com.bartlomiejpluta.base.api.location.Locationable;
 import com.bartlomiejpluta.base.api.map.layer.object.ObjectLayer;
+import com.bartlomiejpluta.base.api.move.CharacterMovement;
 import com.bartlomiejpluta.base.api.move.Direction;
-import com.bartlomiejpluta.base.api.move.EntityMovement;
 import com.bartlomiejpluta.base.api.move.Movement;
 import com.bartlomiejpluta.base.api.screen.Screen;
 import com.bartlomiejpluta.base.internal.object.Placeable;
@@ -18,300 +19,300 @@ import org.joml.Vector2ic;
 import java.util.concurrent.CompletableFuture;
 import java.util.function.Consumer;
 
-public abstract class EntityDelegate implements Entity {
-   protected final Entity entity;
+public abstract class CharacterDelegate implements Character {
+   protected final Character character;
 
-   protected EntityDelegate(Entity entity) {
-      this.entity = entity;
+   protected CharacterDelegate(Character character) {
+      this.character = character;
    }
 
    @Override
    public void setStepSize(float x, float y) {
-      entity.setStepSize(x, y);
+      character.setStepSize(x, y);
    }
 
    @Override
    public Vector2ic getCoordinates() {
-      return entity.getCoordinates();
+      return character.getCoordinates();
    }
 
    @Override
    public void setCoordinates(Vector2ic coordinates) {
-      entity.setCoordinates(coordinates);
+      character.setCoordinates(coordinates);
    }
 
    @Override
    public void setCoordinates(int x, int y) {
-      entity.setCoordinates(x, y);
+      character.setCoordinates(x, y);
    }
 
    @Override
    public Movement prepareMovement(Direction direction) {
-      return new EntityMovement(this, direction);
+      return new CharacterMovement(this, direction);
    }
 
    @Override
    public Movement getMovement() {
-      return entity.getMovement();
+      return character.getMovement();
    }
 
    @Override
    public Direction getFaceDirection() {
-      return entity.getFaceDirection();
+      return character.getFaceDirection();
    }
 
    @Override
    public void setFaceDirection(Direction direction) {
-      entity.setFaceDirection(direction);
+      character.setFaceDirection(direction);
    }
 
    @Override
    public void setSpeed(float speed) {
-      entity.setSpeed(speed);
+      character.setSpeed(speed);
    }
 
    @Override
    public boolean isAnimationEnabled() {
-      return entity.isAnimationEnabled();
+      return character.isAnimationEnabled();
    }
 
    @Override
    public void setAnimationEnabled(boolean enabled) {
-      entity.setAnimationEnabled(enabled);
+      character.setAnimationEnabled(enabled);
    }
 
    @Override
    public void enableAnimation() {
-      entity.enableAnimation();
+      character.enableAnimation();
    }
 
    @Override
    public void disableAnimation() {
-      entity.disableAnimation();
+      character.disableAnimation();
    }
 
    @Override
    public void toggleAnimationEnabled() {
-      entity.toggleAnimationEnabled();
+      character.toggleAnimationEnabled();
    }
 
    @Override
    public void setAnimationFrame(int frame) {
-      entity.setAnimationFrame(frame);
+      character.setAnimationFrame(frame);
    }
 
    @Override
    public float getAnimationSpeed() {
-      return entity.getAnimationSpeed();
+      return character.getAnimationSpeed();
    }
 
    @Override
    public void setAnimationSpeed(float speed) {
-      entity.setAnimationSpeed(speed);
+      character.setAnimationSpeed(speed);
    }
 
    @Override
    public boolean isMoving() {
-      return entity.isMoving();
+      return character.isMoving();
    }
 
    @Override
    public Vector2fc getPositionOffset() {
-      return entity.getPositionOffset();
+      return character.getPositionOffset();
    }
 
    @Override
    public void setPositionOffset(Vector2fc offset) {
-      entity.setPositionOffset(offset);
+      character.setPositionOffset(offset);
    }
 
    @Override
    public void setPositionOffset(float offsetX, float offsetY) {
-      entity.setPositionOffset(offsetX, offsetY);
+      character.setPositionOffset(offsetX, offsetY);
    }
 
    @Override
-   public int chebyshevDistance(Entity other) {
-      return entity.chebyshevDistance(other);
+   public int chebyshevDistance(Locationable other) {
+      return character.chebyshevDistance(other);
    }
 
    @Override
-   public int manhattanDistance(Entity other) {
-      return entity.manhattanDistance(other);
+   public int manhattanDistance(Locationable other) {
+      return character.manhattanDistance(other);
    }
 
    @Override
-   public Direction getDirectionTowards(Entity target) {
-      return entity.getDirectionTowards(target);
+   public Direction getDirectionTowards(Locationable target) {
+      return character.getDirectionTowards(target);
    }
 
    @Override
    public Vector2fc getPosition() {
-      return entity.getPosition();
-   }
-
-   @Override
-   public void setPosition(float x, float y) {
-      entity.setPosition(x, y);
+      return character.getPosition();
    }
 
    @Override
    public void setPosition(Vector2fc position) {
-      entity.setPosition(position);
+      character.setPosition(position);
+   }
+
+   @Override
+   public void setPosition(float x, float y) {
+      character.setPosition(x, y);
    }
 
    @Override
    public void movePosition(float x, float y) {
-      entity.movePosition(x, y);
+      character.movePosition(x, y);
    }
 
    @Override
    public void movePosition(Vector2fc position) {
-      entity.movePosition(position);
+      character.movePosition(position);
    }
 
    @Override
    public float getRotation() {
-      return entity.getRotation();
+      return character.getRotation();
    }
 
    @Override
    public void setRotation(float rotation) {
-      entity.setRotation(rotation);
+      character.setRotation(rotation);
    }
 
    @Override
    public void moveRotation(float rotation) {
-      entity.moveRotation(rotation);
+      character.moveRotation(rotation);
    }
 
    @Override
    public float getScaleX() {
-      return entity.getScaleX();
+      return character.getScaleX();
    }
 
    @Override
    public void setScaleX(float scale) {
-      entity.setScaleX(scale);
+      character.setScaleX(scale);
    }
 
    @Override
    public float getScaleY() {
-      return entity.getScaleY();
+      return character.getScaleY();
    }
 
    @Override
    public void setScaleY(float scale) {
-      entity.setScaleY(scale);
+      character.setScaleY(scale);
    }
 
    @Override
    public void setScale(float scale) {
-      entity.setScale(scale);
+      character.setScale(scale);
    }
 
    @Override
    public void setScale(float scaleX, float scaleY) {
-      entity.setScale(scaleX, scaleY);
+      character.setScale(scaleX, scaleY);
    }
 
    @Override
    public float euclideanDistance(Placeable other) {
-      return entity.euclideanDistance(other);
+      return character.euclideanDistance(other);
    }
 
    @Override
    public int chebyshevDistance(Vector2ic coordinates) {
-      return entity.chebyshevDistance(coordinates);
+      return character.chebyshevDistance(coordinates);
    }
 
    @Override
    public int manhattanDistance(Vector2ic coordinates) {
-      return entity.manhattanDistance(coordinates);
+      return character.manhattanDistance(coordinates);
    }
 
    @Override
    public Matrix4fc getModelMatrix() {
-      return entity.getModelMatrix();
+      return character.getModelMatrix();
    }
 
    @Override
    public ObjectLayer getLayer() {
-      return entity.getLayer();
+      return character.getLayer();
    }
 
    @Override
    public void onAdd(ObjectLayer layer) {
-      entity.onAdd(layer);
+      character.onAdd(layer);
    }
 
    @Override
    public void onRemove(ObjectLayer layer) {
-      entity.onRemove(layer);
+      character.onRemove(layer);
    }
 
    @Override
    public boolean isBlocking() {
-      return entity.isBlocking();
+      return character.isBlocking();
    }
 
    @Override
    public void setBlocking(boolean blocking) {
-      entity.setBlocking(blocking);
+      character.setBlocking(blocking);
    }
 
    @Override
-   public void changeEntitySet(String entitySetUid) {
-      entity.changeEntitySet(entitySetUid);
+   public void changeCharacterSet(String characterSetUid) {
+      character.changeCharacterSet(characterSetUid);
    }
 
    @Override
    public int getZIndex() {
-      return entity.getZIndex();
+      return character.getZIndex();
    }
 
    @Override
    public void setZIndex(int zIndex) {
-      entity.setZIndex(zIndex);
+      character.setZIndex(zIndex);
    }
 
    @Override
    public <E extends Event> void handleEvent(E event) {
-      entity.handleEvent(event);
+      character.handleEvent(event);
    }
 
    @Override
    public <E extends Event> void addEventListener(EventType<E> type, Consumer<E> listener) {
-      entity.addEventListener(type, listener);
+      character.addEventListener(type, listener);
    }
 
    @Override
    public <E extends Event> void removeEventListener(EventType<E> type, Consumer<E> listener) {
-      entity.removeEventListener(type, listener);
+      character.removeEventListener(type, listener);
    }
 
    @Override
    public CompletableFuture<Void> performInstantAnimation() {
-      return entity.performInstantAnimation();
+      return character.performInstantAnimation();
    }
 
    @Override
    public boolean move(Movement movement) {
-      return entity.move(movement);
+      return character.move(movement);
    }
 
    @Override
    public void abortMove() {
-      entity.abortMove();
+      character.abortMove();
    }
 
    @Override
    public void update(float dt) {
-      entity.update(dt);
+      character.update(dt);
    }
 
    @Override
    public void render(Screen screen, Camera camera, ShaderManager shaderManager) {
-      entity.render(screen, camera, shaderManager);
+      character.render(screen, camera, shaderManager);
    }
 }

api/src/main/java/com/bartlomiejpluta/base/util/path/CharacterPath.java

@@ -1,53 +1,53 @@
 package com.bartlomiejpluta.base.util.path;
 
-import com.bartlomiejpluta.base.api.entity.Entity;
+import com.bartlomiejpluta.base.api.character.Character;
 import com.bartlomiejpluta.base.api.move.Direction;
 import lombok.Getter;
 
 import java.util.ArrayList;
 import java.util.List;
 
-public class EntityPath<T extends Entity> implements Path<T> {
+public class CharacterPath<T extends Character> implements Path<T> {
 
    @Getter
    private final List<PathSegment<T>> path = new ArrayList<>();
 
-   public EntityPath<T> add(PathSegment<T> segment) {
+   public CharacterPath<T> add(PathSegment<T> segment) {
       path.add(segment);
       return this;
    }
 
-   public EntityPath<T> addFirst(PathSegment<T> segment) {
+   public CharacterPath<T> addFirst(PathSegment<T> segment) {
       path.add(0, segment);
       return this;
    }
 
-   public EntityPath<T> move(Direction direction) {
+   public CharacterPath<T> move(Direction direction) {
       path.add(new MoveSegment<>(direction));
       return this;
    }
 
-   public EntityPath<T> move(Direction direction, boolean ignore) {
+   public CharacterPath<T> move(Direction direction, boolean ignore) {
       path.add(new MoveSegment<>(direction, ignore));
       return this;
    }
 
-   public EntityPath<T> turn(Direction direction) {
+   public CharacterPath<T> turn(Direction direction) {
       path.add(new TurnSegment<>(direction));
       return this;
    }
 
-   public EntityPath<T> turn(Direction direction, int newAnimationFrame) {
+   public CharacterPath<T> turn(Direction direction, int newAnimationFrame) {
       path.add(new TurnSegment<>(direction, newAnimationFrame));
       return this;
    }
 
-   public EntityPath<T> wait(float seconds) {
+   public CharacterPath<T> wait(float seconds) {
       path.add(new WaitSegment<>(seconds));
       return this;
    }
 
-   public EntityPath<T> run(Runnable runnable) {
+   public CharacterPath<T> run(Runnable runnable) {
       path.add(new RunSegment<>(runnable));
       return this;
    }

api/src/main/java/com/bartlomiejpluta/base/util/path/TurnSegment.java

@@ -1,13 +1,11 @@
 package com.bartlomiejpluta.base.util.path;
 
-import com.bartlomiejpluta.base.api.entity.Entity;
+import com.bartlomiejpluta.base.api.character.Character;
 import com.bartlomiejpluta.base.api.map.layer.object.ObjectLayer;
 import com.bartlomiejpluta.base.api.move.Direction;
 import lombok.NonNull;
 
-import static java.util.Objects.requireNonNull;
-
-public class TurnSegment<T extends Entity> implements PathSegment<T> {
+public class TurnSegment<T extends Character> implements PathSegment<T> {
    private final Direction direction;
    private final Integer newAnimationFrame;
 
@@ -22,10 +20,10 @@ public class TurnSegment<T extends Entity> implements PathSegment<T> {
    }
 
    @Override
-   public PathProgress perform(T entity, ObjectLayer layer, float dt) {
-      entity.setFaceDirection(direction);
+   public PathProgress perform(T character, ObjectLayer layer, float dt) {
+      character.setFaceDirection(direction);
       if (newAnimationFrame != null) {
-         entity.setAnimationFrame(newAnimationFrame);
+         character.setAnimationFrame(newAnimationFrame);
       }
       return PathProgress.SEGMENT_DONE;
    }

api/src/main/java/com/bartlomiejpluta/base/util/world/CharacterSpawner.java

@@ -1,8 +1,8 @@
 package com.bartlomiejpluta.base.util.world;
 
 import com.bartlomiejpluta.base.api.camera.Camera;
+import com.bartlomiejpluta.base.api.character.Character;
 import com.bartlomiejpluta.base.api.context.Context;
-import com.bartlomiejpluta.base.api.entity.Entity;
 import com.bartlomiejpluta.base.api.event.Event;
 import com.bartlomiejpluta.base.api.event.EventType;
 import com.bartlomiejpluta.base.api.map.layer.object.ObjectLayer;
@@ -22,11 +22,11 @@ import java.util.Random;
 import java.util.function.Supplier;
 
 
-public class EntitySpawner implements Updatable {
+public class CharacterSpawner implements Updatable {
    private static final int MAX_REPOSITION_ATTEMPTS = 10;
    private final Random random = new Random();
-   private final List<Entity> spawnedEntities = new LinkedList<>();
-   private final List<Supplier<Entity>> spawners = new ArrayList<>();
+   private final List<Character> spawnedEntities = new LinkedList<>();
+   private final List<Supplier<Character>> spawners = new ArrayList<>();
    private final Vector2ic origin;
    private final Context context;
    private final Camera camera;
@@ -36,12 +36,12 @@ public class EntitySpawner implements Updatable {
    private int range = 4;
    private float spawnChance = 50;
    private DiceRoller countRoller = DiceRoller.of("1d4");
-   private EventType<? extends Event> entityRemoveEvent;
+   private EventType<? extends Event> characterRemoveEvent;
    private float accumulator = 10000f;
    private boolean spawnOutsideViewport = false;
    private float threshold;
 
-   public EntitySpawner(int x, int y, @NonNull Context context, @NonNull GameMap map, @NonNull ObjectLayer layer) {
+   public CharacterSpawner(int x, int y, @NonNull Context context, @NonNull GameMap map, @NonNull ObjectLayer layer) {
       this.origin = new Vector2i(x, y);
       this.context = context;
       this.camera = context.getCamera();
@@ -50,43 +50,43 @@ public class EntitySpawner implements Updatable {
       drawThreshold();
    }
 
-   public EntitySpawner interval(@NonNull String interval) {
+   public CharacterSpawner interval(@NonNull String interval) {
       this.interval = DiceRoller.of(interval);
       drawThreshold();
       return this;
    }
 
-   public EntitySpawner range(int range) {
+   public CharacterSpawner range(int range) {
       this.range = range;
       return this;
    }
 
-   public EntitySpawner spawnChance(float change) {
+   public CharacterSpawner spawnChance(float change) {
       this.spawnChance = change;
       return this;
    }
 
-   public EntitySpawner count(String dices) {
+   public CharacterSpawner count(String dices) {
       this.countRoller = DiceRoller.of(dices);
       return this;
    }
 
-   public EntitySpawner trackEntities(@NonNull EventType<? extends Event> entityRemoveEvent) {
-      this.entityRemoveEvent = entityRemoveEvent;
+   public CharacterSpawner trackEntities(@NonNull EventType<? extends Event> characterRemoveEvent) {
+      this.characterRemoveEvent = characterRemoveEvent;
       return this;
    }
 
-   public EntitySpawner spawnOutsideViewport() {
+   public CharacterSpawner spawnOutsideViewport() {
       this.spawnOutsideViewport = true;
       return this;
    }
 
-   public EntitySpawner spawnOnCreate() {
+   public CharacterSpawner spawnOnCreate() {
       this.threshold = 0;
       return this;
    }
 
-   public EntitySpawner spawn(@NonNull Supplier<Entity> spawner) {
+   public CharacterSpawner spawn(@NonNull Supplier<Character> spawner) {
       this.spawners.add(spawner);
       return this;
    }
@@ -151,19 +151,19 @@ public class EntitySpawner implements Updatable {
             break;
          }
 
-         // Draw the entity spawner
+         // Draw the character spawner
          var spawner = spawners.get(random.nextInt(spawners.size()));
 
-         // Create the entity and push it onto the map layer
-         var entity = spawner.get();
-         entity.setCoordinates(coordinates);
-         layer.addEntity(entity);
+         // Create the character and push it onto the map layer
+         var character = spawner.get();
+         character.setCoordinates(coordinates);
+         layer.addEntity(character);
 
          // If we want to keep the number of spawned entities per spawner almost constant
-         // we need to know when the entity should be removed (i.e. it has been killed by player).
-         if (entityRemoveEvent != null) {
-            spawnedEntities.add(entity);
-            entity.addEventListener(entityRemoveEvent, e -> spawnedEntities.remove(entity));
+         // we need to know when the character should be removed (i.e. it has been killed by player).
+         if (characterRemoveEvent != null) {
+            spawnedEntities.add(character);
+            character.addEventListener(characterRemoveEvent, e -> spawnedEntities.remove(character));
          }
       }
    }

engine/src/main/java/com/bartlomiejpluta/base/engine/context/manager/DefaultContextManager.java

@@ -14,8 +14,8 @@ import com.bartlomiejpluta.base.engine.project.config.ProjectConfiguration;
 import com.bartlomiejpluta.base.engine.project.serial.ProjectDeserializer;
 import com.bartlomiejpluta.base.engine.util.reflection.ClassLoader;
 import com.bartlomiejpluta.base.engine.world.animation.manager.AnimationManager;
-import com.bartlomiejpluta.base.engine.world.entity.manager.EntityManager;
-import com.bartlomiejpluta.base.engine.world.entity.manager.EntitySetManager;
+import com.bartlomiejpluta.base.engine.world.character.manager.CharacterManager;
+import com.bartlomiejpluta.base.engine.world.character.manager.CharacterSetManager;
 import com.bartlomiejpluta.base.engine.world.image.manager.ImageManager;
 import com.bartlomiejpluta.base.engine.world.map.manager.MapManager;
 import com.bartlomiejpluta.base.engine.world.tileset.manager.TileSetManager;
@@ -35,9 +35,9 @@ public class DefaultContextManager implements ContextManager {
    private final TileSetManager tileSetManager;
    private final MapManager mapManager;
    private final ImageManager imageManager;
-   private final EntitySetManager entitySetManager;
+   private final CharacterSetManager characterSetManager;
    private final FontManager fontManager;
-   private final EntityManager entityManager;
+   private final CharacterManager characterManager;
    private final AnimationManager animationManager;
    private final ClassLoader classLoader;
    private final Inflater inflater;
@@ -56,7 +56,7 @@ public class DefaultContextManager implements ContextManager {
       project.getTileSetAssets().forEach(tileSetManager::registerAsset);
       project.getMapAssets().forEach(mapManager::registerAsset);
       project.getImageAssets().forEach(imageManager::registerAsset);
-      project.getEntitySetAssets().forEach(entitySetManager::registerAsset);
+      project.getCharacterSetAssets().forEach(characterSetManager::registerAsset);
       project.getAnimationAssets().forEach(animationManager::registerAsset);
       project.getFontAssets().forEach(fontManager::registerAsset);
       project.getWidgetDefinitionAssets().forEach(widgetDefinitionManager::registerAsset);
@@ -68,8 +68,8 @@ public class DefaultContextManager implements ContextManager {
 
       log.info("Building context up");
       var context = DefaultContext.builder()
-            .engine(engine)
-            .entityManager(entityManager)
+              .engine(engine)
+              .characterManager(characterManager)
             .animationManager(animationManager)
             .imageManager(imageManager)
             .mapManager(mapManager)

engine/src/main/java/com/bartlomiejpluta/base/engine/context/model/DefaultContext.java

@@ -3,9 +3,9 @@ package com.bartlomiejpluta.base.engine.context.model;
 import com.bartlomiejpluta.base.api.animation.Animation;
 import com.bartlomiejpluta.base.api.audio.Sound;
 import com.bartlomiejpluta.base.api.camera.Camera;
+import com.bartlomiejpluta.base.api.character.Character;
 import com.bartlomiejpluta.base.api.context.Context;
 import com.bartlomiejpluta.base.api.context.GamePauseEvent;
-import com.bartlomiejpluta.base.api.entity.Entity;
 import com.bartlomiejpluta.base.api.event.Event;
 import com.bartlomiejpluta.base.api.event.EventType;
 import com.bartlomiejpluta.base.api.gui.GUI;
@@ -22,7 +22,7 @@ import com.bartlomiejpluta.base.engine.gui.manager.WidgetDefinitionManager;
 import com.bartlomiejpluta.base.engine.gui.render.NanoVGGUI;
 import com.bartlomiejpluta.base.engine.gui.xml.inflater.Inflater;
 import com.bartlomiejpluta.base.engine.world.animation.manager.AnimationManager;
-import com.bartlomiejpluta.base.engine.world.entity.manager.EntityManager;
+import com.bartlomiejpluta.base.engine.world.character.manager.CharacterManager;
 import com.bartlomiejpluta.base.engine.world.image.manager.ImageManager;
 import com.bartlomiejpluta.base.engine.world.map.manager.MapManager;
 import com.bartlomiejpluta.base.engine.world.map.model.DefaultGameMap;
@@ -50,7 +50,7 @@ public class DefaultContext implements Context {
    private final GameEngine engine;
 
    @NonNull
-   private final EntityManager entityManager;
+   private final CharacterManager characterManager;
 
    @NonNull
    private final AnimationManager animationManager;
@@ -146,9 +146,9 @@ public class DefaultContext implements Context {
    }
 
    @Override
-   public Entity createEntity(String entitySetUid) {
-      log.info("Creating new entity with UID: [{}]", entitySetUid);
-      return entityManager.createEntity(entitySetUid);
+   public Character createCharacter(String characterSetUid) {
+      log.info("Creating new character with UID: [{}]", characterSetUid);
+      return characterManager.createCharacter(characterSetUid);
    }
 
    @Override

engine/src/main/java/com/bartlomiejpluta/base/engine/project/model/Project.java

@@ -4,7 +4,7 @@ import com.bartlomiejpluta.base.engine.audio.asset.SoundAsset;
 import com.bartlomiejpluta.base.engine.gui.asset.FontAsset;
 import com.bartlomiejpluta.base.engine.gui.asset.WidgetDefinitionAsset;
 import com.bartlomiejpluta.base.engine.world.animation.asset.AnimationAsset;
-import com.bartlomiejpluta.base.engine.world.entity.asset.EntitySetAsset;
+import com.bartlomiejpluta.base.engine.world.character.asset.CharacterSetAsset;
 import com.bartlomiejpluta.base.engine.world.image.asset.ImageAsset;
 import com.bartlomiejpluta.base.engine.world.map.asset.GameMapAsset;
 import com.bartlomiejpluta.base.engine.world.tileset.asset.TileSetAsset;
@@ -34,7 +34,7 @@ public class Project {
    private final List<ImageAsset> imageAssets;
 
    @NonNull
-   private final List<EntitySetAsset> entitySetAssets;
+   private final List<CharacterSetAsset> characterSetAssets;
 
    @NonNull
    private final List<AnimationAsset> animationAssets;

engine/src/main/java/com/bartlomiejpluta/base/engine/project/serial/ProtobufProjectDeserializer.java

@@ -5,7 +5,7 @@ import com.bartlomiejpluta.base.engine.gui.asset.FontAsset;
 import com.bartlomiejpluta.base.engine.gui.asset.WidgetDefinitionAsset;
 import com.bartlomiejpluta.base.engine.project.model.Project;
 import com.bartlomiejpluta.base.engine.world.animation.asset.AnimationAsset;
-import com.bartlomiejpluta.base.engine.world.entity.asset.EntitySetAsset;
+import com.bartlomiejpluta.base.engine.world.character.asset.CharacterSetAsset;
 import com.bartlomiejpluta.base.engine.world.image.asset.ImageAsset;
 import com.bartlomiejpluta.base.engine.world.map.asset.GameMapAsset;
 import com.bartlomiejpluta.base.engine.world.tileset.asset.TileSetAsset;
@@ -24,12 +24,12 @@ public class ProtobufProjectDeserializer extends ProjectDeserializer {
       var proto = ProjectProto.Project.parseFrom(input);
 
       return Project.builder()
-            .name(proto.getName())
-            .runner(proto.getRunner())
-            .tileSetAssets(proto.getTileSetsList().stream().map(this::parseTileSetAsset).collect(toList()))
-            .mapAssets(proto.getMapsList().stream().map(this::parseGameMapAsset).collect(toList()))
-            .imageAssets(proto.getImagesList().stream().map(this::parseImageAsset).collect(toList()))
-            .entitySetAssets(proto.getEntitySetsList().stream().map(this::parseEntitySetAsset).collect(toList()))
+              .name(proto.getName())
+              .runner(proto.getRunner())
+              .tileSetAssets(proto.getTileSetsList().stream().map(this::parseTileSetAsset).collect(toList()))
+              .mapAssets(proto.getMapsList().stream().map(this::parseGameMapAsset).collect(toList()))
+              .imageAssets(proto.getImagesList().stream().map(this::parseImageAsset).collect(toList()))
+              .characterSetAssets(proto.getEntitySetsList().stream().map(this::parseEntitySetAsset).collect(toList()))
             .animationAssets(proto.getAnimationsList().stream().map(this::parseAnimationAsset).collect(toList()))
             .fontAssets(proto.getFontsList().stream().map(this::parseFontAsset).collect(toList()))
             .widgetDefinitionAssets(proto.getWidgetsList().stream().map(this::parseWidgetAsset).collect(toList()))
@@ -49,8 +49,8 @@ public class ProtobufProjectDeserializer extends ProjectDeserializer {
       return new ImageAsset(proto.getUid(), proto.getSource());
    }
 
-   private EntitySetAsset parseEntitySetAsset(ProjectProto.EntitySetAsset proto) {
-      return new EntitySetAsset(proto.getUid(), proto.getSource(), proto.getRows(), proto.getColumns());
+   private CharacterSetAsset parseEntitySetAsset(ProjectProto.EntitySetAsset proto) {
+      return new CharacterSetAsset(proto.getUid(), proto.getSource(), proto.getRows(), proto.getColumns());
    }
 
    private FontAsset parseFontAsset(ProjectProto.FontAsset proto) {

engine/src/main/java/com/bartlomiejpluta/base/engine/world/animation/manager/DefaultAnimationManager.java

@@ -46,7 +46,7 @@ public class DefaultAnimationManager implements AnimationManager {
       var asset = assets.get(uid);
 
       if (asset == null) {
-         throw new AppException("The entity set asset with UID: [%s] does not exist", uid);
+         throw new AppException("The animation asset with UID: [%s] does not exist", uid);
       }
 
       var animationFrames = frames.computeIfAbsent(asset.framesSignature(),

engine/src/main/java/com/bartlomiejpluta/base/engine/world/character/asset/CharacterSetAsset.java

@@ -1,15 +1,15 @@
-package com.bartlomiejpluta.base.engine.world.entity.asset;
+package com.bartlomiejpluta.base.engine.world.character.asset;
 
 import com.bartlomiejpluta.base.engine.common.asset.Asset;
 import lombok.Getter;
 import lombok.NonNull;
 
 @Getter
-public class EntitySetAsset extends Asset {
+public class CharacterSetAsset extends Asset {
    private final int rows;
    private final int columns;
 
-   public EntitySetAsset(@NonNull String uid, @NonNull String source, int rows, int columns) {
+   public CharacterSetAsset(@NonNull String uid, @NonNull String source, int rows, int columns) {
       super(uid, source);
       this.rows = rows;
       this.columns = columns;

engine/src/main/java/com/bartlomiejpluta/base/engine/world/character/config/CharacterSpriteConfiguration.java

@@ -1,4 +1,4 @@
-package com.bartlomiejpluta.base.engine.world.entity.config;
+package com.bartlomiejpluta.base.engine.world.character.config;
 
 import com.bartlomiejpluta.base.api.move.Direction;
 import lombok.Data;
@@ -9,8 +9,8 @@ import java.util.Map;
 
 @Data
 @Configuration
-@ConfigurationProperties(prefix = "app.sprite.entity")
-public class EntitySpriteConfiguration {
+@ConfigurationProperties(prefix = "app.sprite.character")
+public class CharacterSpriteConfiguration {
    private int defaultSpriteColumn;
    private Map<Direction, Integer> spriteDirectionRows;
 }

engine/src/main/java/com/bartlomiejpluta/base/engine/world/character/manager/CharacterManager.java

@@ -0,0 +1,9 @@
+package com.bartlomiejpluta.base.engine.world.character.manager;
+
+import com.bartlomiejpluta.base.api.character.Character;
+import com.bartlomiejpluta.base.engine.common.init.Initializable;
+import com.bartlomiejpluta.base.internal.gc.Cleanable;
+
+public interface CharacterManager extends Initializable, Cleanable {
+   Character createCharacter(String characterSetUid);
+}

engine/src/main/java/com/bartlomiejpluta/base/engine/world/character/manager/CharacterSetManager.java

@@ -0,0 +1,8 @@
+package com.bartlomiejpluta.base.engine.world.character.manager;
+
+import com.bartlomiejpluta.base.engine.common.manager.AssetManager;
+import com.bartlomiejpluta.base.engine.core.gl.object.material.Material;
+import com.bartlomiejpluta.base.engine.world.character.asset.CharacterSetAsset;
+
+public interface CharacterSetManager extends AssetManager<CharacterSetAsset, Material> {
+}

engine/src/main/java/com/bartlomiejpluta/base/engine/world/character/manager/DefaultCharacterManager.java

@@ -1,11 +1,11 @@
-package com.bartlomiejpluta.base.engine.world.entity.manager;
+package com.bartlomiejpluta.base.engine.world.character.manager;
 
-import com.bartlomiejpluta.base.api.entity.Entity;
+import com.bartlomiejpluta.base.api.character.Character;
 import com.bartlomiejpluta.base.api.move.Direction;
 import com.bartlomiejpluta.base.engine.core.gl.object.mesh.Mesh;
 import com.bartlomiejpluta.base.engine.util.mesh.MeshManager;
-import com.bartlomiejpluta.base.engine.world.entity.config.EntitySpriteConfiguration;
-import com.bartlomiejpluta.base.engine.world.entity.model.DefaultEntity;
+import com.bartlomiejpluta.base.engine.world.character.config.CharacterSpriteConfiguration;
+import com.bartlomiejpluta.base.engine.world.character.model.DefaultCharacter;
 import lombok.extern.slf4j.Slf4j;
 import org.joml.Vector2f;
 import org.joml.Vector2fc;
@@ -19,9 +19,9 @@ import static java.util.stream.Collectors.toUnmodifiableMap;
 
 @Slf4j
 @Component
-public class DefaultEntityManager implements EntityManager {
+public class DefaultCharacterManager implements CharacterManager {
    private final MeshManager meshManager;
-   private final EntitySetManager entitySetManager;
+   private final CharacterSetManager characterSetManager;
 
    private final int defaultSpriteColumn;
    private final Map<Direction, Integer> spriteDirectionRows;
@@ -30,17 +30,17 @@ public class DefaultEntityManager implements EntityManager {
    private Mesh mesh;
 
    @Autowired
-   public DefaultEntityManager(MeshManager meshManager, EntitySetManager entitySetManager, EntitySpriteConfiguration configuration) {
+   public DefaultCharacterManager(MeshManager meshManager, CharacterSetManager characterSetManager, CharacterSpriteConfiguration configuration) {
       this.meshManager = meshManager;
-      this.entitySetManager = entitySetManager;
+      this.characterSetManager = characterSetManager;
 
       this.spriteDirectionRows = configuration.getSpriteDirectionRows();
 
       defaultSpriteColumn = configuration.getDefaultSpriteColumn();
       this.spriteDefaultRows = spriteDirectionRows
-            .entrySet()
-            .stream()
-            .collect(toUnmodifiableMap(Entry::getKey, entry -> new Vector2f(defaultSpriteColumn, entry.getValue())));
+              .entrySet()
+              .stream()
+              .collect(toUnmodifiableMap(Entry::getKey, entry -> new Vector2f(defaultSpriteColumn, entry.getValue())));
    }
 
    @Override
@@ -49,8 +49,8 @@ public class DefaultEntityManager implements EntityManager {
    }
 
    @Override
-   public Entity createEntity(String entitySetUid) {
-      return new DefaultEntity(mesh, entitySetManager, defaultSpriteColumn, spriteDirectionRows, spriteDefaultRows, entitySetUid);
+   public Character createCharacter(String characterSetUid) {
+      return new DefaultCharacter(mesh, characterSetManager, defaultSpriteColumn, spriteDirectionRows, spriteDefaultRows, characterSetUid);
    }
 
    @Override

engine/src/main/java/com/bartlomiejpluta/base/engine/world/character/manager/DefaultCharacterSetManager.java

@@ -1,10 +1,10 @@
-package com.bartlomiejpluta.base.engine.world.entity.manager;
+package com.bartlomiejpluta.base.engine.world.character.manager;
 
 import com.bartlomiejpluta.base.engine.core.gl.object.material.Material;
 import com.bartlomiejpluta.base.engine.core.gl.object.texture.TextureManager;
 import com.bartlomiejpluta.base.engine.error.AppException;
 import com.bartlomiejpluta.base.engine.project.config.ProjectConfiguration;
-import com.bartlomiejpluta.base.engine.world.entity.asset.EntitySetAsset;
+import com.bartlomiejpluta.base.engine.world.character.asset.CharacterSetAsset;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.beans.factory.annotation.Autowired;
@@ -16,14 +16,14 @@ import java.util.Map;
 @Slf4j
 @Component
 @RequiredArgsConstructor(onConstructor = @__(@Autowired))
-public class DefaultEntitySetManager implements EntitySetManager {
+public class DefaultCharacterSetManager implements CharacterSetManager {
    private final TextureManager textureManager;
-   private final Map<String, EntitySetAsset> assets = new HashMap<>();
+   private final Map<String, CharacterSetAsset> assets = new HashMap<>();
    private final ProjectConfiguration configuration;
 
    @Override
-   public void registerAsset(EntitySetAsset asset) {
-      log.info("Registering [{}] entity set asset under UID: [{}]", asset.getSource(), asset.getUid());
+   public void registerAsset(CharacterSetAsset asset) {
+      log.info("Registering [{}] character set asset under UID: [{}]", asset.getSource(), asset.getUid());
       assets.put(asset.getUid(), asset);
    }
 
@@ -32,7 +32,7 @@ public class DefaultEntitySetManager implements EntitySetManager {
       var asset = assets.get(uid);
 
       if (asset == null) {
-         throw new AppException("The entity set asset with UID: [%s] does not exist", uid);
+         throw new AppException("The character set asset with UID: [%s] does not exist", uid);
       }
 
       var source = configuration.projectFile("entsets", asset.getSource());

engine/src/main/java/com/bartlomiejpluta/base/engine/world/character/model/CharacterInstantAnimation.java

@@ -1,13 +1,13 @@
-package com.bartlomiejpluta.base.engine.world.entity.model;
+package com.bartlomiejpluta.base.engine.world.character.model;
 
 import lombok.Getter;
 
 import java.util.concurrent.CompletableFuture;
 
-public class EntityInstantAnimation {
+public class CharacterInstantAnimation {
    public enum State {RUNNING, COMPLETED}
 
-   private final DefaultEntity entity;
+   private final DefaultCharacter character;
    private final int firstFrame;
    private final int lastFrame;
 
@@ -16,19 +16,19 @@ public class EntityInstantAnimation {
    @Getter
    private final CompletableFuture<Void> future = new CompletableFuture<>();
 
-   EntityInstantAnimation(DefaultEntity entity, int firstFrame) {
-      this.entity = entity;
+   CharacterInstantAnimation(DefaultCharacter character, int firstFrame) {
+      this.character = character;
       this.firstFrame = firstFrame;
-      this.lastFrame = entity.getMaterial().getTexture().getColumns() - 1;
+      this.lastFrame = character.getMaterial().getTexture().getColumns() - 1;
    }
 
    public State update() {
-      if (!finished && entity.currentFrame() == lastFrame) {
+      if (!finished && character.currentFrame() == lastFrame) {
          finished = true;
          return State.RUNNING;
       }
 
-      if (finished && entity.currentFrame() == firstFrame) {
+      if (finished && character.currentFrame() == firstFrame) {
          future.complete(null);
 
          return State.COMPLETED;

engine/src/main/java/com/bartlomiejpluta/base/engine/world/character/model/DefaultCharacter.java

@@ -1,16 +1,16 @@
-package com.bartlomiejpluta.base.engine.world.entity.model;
+package com.bartlomiejpluta.base.engine.world.character.model;
 
-import com.bartlomiejpluta.base.api.entity.Entity;
+import com.bartlomiejpluta.base.api.character.Character;
 import com.bartlomiejpluta.base.api.event.Event;
 import com.bartlomiejpluta.base.api.event.EventType;
 import com.bartlomiejpluta.base.api.map.layer.object.ObjectLayer;
+import com.bartlomiejpluta.base.api.move.CharacterMovement;
 import com.bartlomiejpluta.base.api.move.Direction;
-import com.bartlomiejpluta.base.api.move.EntityMovement;
 import com.bartlomiejpluta.base.api.move.Movement;
 import com.bartlomiejpluta.base.engine.core.gl.object.material.Material;
 import com.bartlomiejpluta.base.engine.core.gl.object.mesh.Mesh;
 import com.bartlomiejpluta.base.engine.error.AppException;
-import com.bartlomiejpluta.base.engine.world.entity.manager.EntitySetManager;
+import com.bartlomiejpluta.base.engine.world.character.manager.CharacterSetManager;
 import com.bartlomiejpluta.base.engine.world.movement.MovableSprite;
 import com.bartlomiejpluta.base.lib.event.EventHandler;
 import lombok.EqualsAndHashCode;
@@ -18,7 +18,6 @@ import lombok.Getter;
 import lombok.Setter;
 import org.joml.Vector2f;
 import org.joml.Vector2fc;
-import org.joml.Vector2i;
 
 import java.util.LinkedList;
 import java.util.Map;
@@ -29,9 +28,9 @@ import java.util.function.Consumer;
 import static java.util.Objects.requireNonNull;
 
 @EqualsAndHashCode(callSuper = true)
-public class DefaultEntity extends MovableSprite implements Entity {
+public class DefaultCharacter extends MovableSprite implements Character {
    private final int defaultSpriteColumn;
-   private final EntitySetManager entitySetManager;
+   private final CharacterSetManager characterSetManager;
    private final Map<Direction, Integer> spriteDirectionRows;
    private final Map<Direction, Vector2fc> spriteDefaultRows;
    private final Vector2f entityScale = new Vector2f(1, 1);
@@ -55,12 +54,12 @@ public class DefaultEntity extends MovableSprite implements Entity {
 
    private boolean animationEnabled = true;
 
-   private final Queue<EntityInstantAnimation> instantAnimations = new LinkedList<>();
+   private final Queue<CharacterInstantAnimation> instantAnimations = new LinkedList<>();
 
-   public DefaultEntity(Mesh mesh, EntitySetManager entitySetManager, int defaultSpriteColumn, Map<Direction, Integer> spriteDirectionRows, Map<Direction, Vector2fc> spriteDefaultRows, String entitySetUid) {
-      super(mesh, createMaterial(entitySetManager, entitySetUid));
+   public DefaultCharacter(Mesh mesh, CharacterSetManager characterSetManager, int defaultSpriteColumn, Map<Direction, Integer> spriteDirectionRows, Map<Direction, Vector2fc> spriteDefaultRows, String entitySetUid) {
+      super(mesh, createMaterial(characterSetManager, entitySetUid));
       this.defaultSpriteColumn = defaultSpriteColumn;
-      this.entitySetManager = entitySetManager;
+      this.characterSetManager = characterSetManager;
       this.spriteDirectionRows = spriteDirectionRows;
       this.faceDirection = Direction.DOWN;
       this.spriteDefaultRows = spriteDefaultRows;
@@ -72,17 +71,8 @@ public class DefaultEntity extends MovableSprite implements Entity {
       }
    }
 
-   @Override
-   public void changeEntitySet(String entitySetUid) {
-      this.material = createMaterial(entitySetManager, entitySetUid);
-      var texture = this.material.getTexture();
-
-      if (texture != null) {
-         this.entitySetSize = texture.getSpriteSize();
-         super.setScale(entitySetSize.x() * entityScale.x, entitySetSize.y() * entityScale.y);
-      } else {
-         this.entitySetSize = null;
-      }
+   private static Material createMaterial(CharacterSetManager characterSetManager, String entitySetUid) {
+      return entitySetUid != null ? characterSetManager.loadObject(requireNonNull(entitySetUid)) : Material.colored(0, 0, 0, 0);
    }
 
    @Override
@@ -134,16 +124,24 @@ public class DefaultEntity extends MovableSprite implements Entity {
    }
 
    @Override
-   public CompletableFuture<Void> performInstantAnimation() {
-      var animation = new EntityInstantAnimation(this, defaultSpriteColumn);
-      instantAnimations.add(animation);
+   public void changeCharacterSet(String entitySetUid) {
+      this.material = createMaterial(characterSetManager, entitySetUid);
+      var texture = this.material.getTexture();
 
-      return animation.getFuture();
+      if (texture != null) {
+         this.entitySetSize = texture.getSpriteSize();
+         super.setScale(entitySetSize.x() * entityScale.x, entitySetSize.y() * entityScale.y);
+      } else {
+         this.entitySetSize = null;
+      }
    }
 
    @Override
-   public Movement prepareMovement(Direction direction) {
-      return new EntityMovement(this, direction);
+   public CompletableFuture<Void> performInstantAnimation() {
+      var animation = new CharacterInstantAnimation(this, defaultSpriteColumn);
+      instantAnimations.add(animation);
+
+      return animation.getFuture();
    }
 
    @Override
@@ -162,21 +160,6 @@ public class DefaultEntity extends MovableSprite implements Entity {
       setDefaultAnimationFrame();
    }
 
-   @Override
-   public int chebyshevDistance(Entity other) {
-      return chebyshevDistance(other.getCoordinates());
-   }
-
-   @Override
-   public int manhattanDistance(Entity other) {
-      return manhattanDistance(other.getCoordinates());
-   }
-
-   @Override
-   public Direction getDirectionTowards(Entity target) {
-      return Direction.ofVector(target.getCoordinates().sub(getCoordinates(), new Vector2i()));
-   }
-
    @Override
    public void onAdd(ObjectLayer layer) {
       this.layer = layer;
@@ -187,10 +170,15 @@ public class DefaultEntity extends MovableSprite implements Entity {
       this.layer = null;
    }
 
+   @Override
+   public Movement prepareMovement(Direction direction) {
+      return new CharacterMovement(this, direction);
+   }
+
    @Override
    public void setScaleX(float scaleX) {
       if (entitySetSize == null) {
-         throw new AppException("Cannot change Entity scale if no Entity Set is provided");
+         throw new AppException("Cannot change Character scale if no Character Set is provided");
       }
 
       this.entityScale.x = scaleX;
@@ -200,7 +188,7 @@ public class DefaultEntity extends MovableSprite implements Entity {
    @Override
    public void setScaleY(float scaleY) {
       if (entitySetSize == null) {
-         throw new AppException("Cannot change Entity scale if no Entity Set is provided");
+         throw new AppException("Cannot change Character scale if no Character Set is provided");
       }
 
       this.entityScale.y = scaleY;
@@ -210,7 +198,7 @@ public class DefaultEntity extends MovableSprite implements Entity {
    @Override
    public void setScale(float scale) {
       if (entitySetSize == null) {
-         throw new AppException("Cannot change Entity scale if no Entity Set is provided");
+         throw new AppException("Cannot change Character scale if no Character Set is provided");
       }
 
       this.entityScale.x = scale;
@@ -218,17 +206,6 @@ public class DefaultEntity extends MovableSprite implements Entity {
       super.setScale(entitySetSize.x() * scale, entitySetSize.y() * scale);
    }
 
-   @Override
-   public void setScale(float scaleX, float scaleY) {
-      if (entitySetSize == null) {
-         throw new AppException("Cannot change Entity scale if no Entity Set is provided");
-      }
-
-      this.entityScale.x = scaleX;
-      this.entityScale.y = scaleY;
-      super.setScale(entitySetSize.x() * scaleX, entitySetSize.y() * scaleY);
-   }
-
    @Override
    public float getScaleX() {
       return entityScale.x;
@@ -255,20 +232,27 @@ public class DefaultEntity extends MovableSprite implements Entity {
    }
 
    @Override
-   public void update(float dt) {
-      super.update(dt);
-
-      var instantAnimation = instantAnimations.peek();
-      if (instantAnimation != null && instantAnimation.update() == EntityInstantAnimation.State.COMPLETED) {
-         instantAnimations.poll();
+   public void setScale(float scaleX, float scaleY) {
+      if (entitySetSize == null) {
+         throw new AppException("Cannot change Character scale if no Character Set is provided");
       }
+
+      this.entityScale.x = scaleX;
+      this.entityScale.y = scaleY;
+      super.setScale(entitySetSize.x() * scaleX, entitySetSize.y() * scaleY);
    }
 
    int currentFrame() {
       return currentAnimationFrame;
    }
 
-   private static Material createMaterial(EntitySetManager entitySetManager, String entitySetUid) {
-      return entitySetUid != null ? entitySetManager.loadObject(requireNonNull(entitySetUid)) : Material.colored(0, 0, 0, 0);
+   @Override
+   public void update(float dt) {
+      super.update(dt);
+
+      var instantAnimation = instantAnimations.peek();
+      if (instantAnimation != null && instantAnimation.update() == CharacterInstantAnimation.State.COMPLETED) {
+         instantAnimations.poll();
+      }
    }
 }

engine/src/main/java/com/bartlomiejpluta/base/engine/world/entity/manager/EntityManager.java

@@ -1,9 +0,0 @@
-package com.bartlomiejpluta.base.engine.world.entity.manager;
-
-import com.bartlomiejpluta.base.api.entity.Entity;
-import com.bartlomiejpluta.base.engine.common.init.Initializable;
-import com.bartlomiejpluta.base.internal.gc.Cleanable;
-
-public interface EntityManager extends Initializable, Cleanable {
-   Entity createEntity(String entitySetUid);
-}

engine/src/main/java/com/bartlomiejpluta/base/engine/world/entity/manager/EntitySetManager.java

@@ -1,8 +0,0 @@
-package com.bartlomiejpluta.base.engine.world.entity.manager;
-
-import com.bartlomiejpluta.base.engine.common.manager.AssetManager;
-import com.bartlomiejpluta.base.engine.core.gl.object.material.Material;
-import com.bartlomiejpluta.base.engine.world.entity.asset.EntitySetAsset;
-
-public interface EntitySetManager extends AssetManager<EntitySetAsset, Material> {
-}

engine/src/main/java/com/bartlomiejpluta/base/engine/world/location/LocationableSprite.java

@@ -1,9 +1,9 @@
 package com.bartlomiejpluta.base.engine.world.location;
 
 import com.bartlomiejpluta.base.api.location.Locationable;
+import com.bartlomiejpluta.base.api.move.Direction;
 import com.bartlomiejpluta.base.engine.core.gl.object.material.Material;
 import com.bartlomiejpluta.base.engine.core.gl.object.mesh.Mesh;
-import com.bartlomiejpluta.base.engine.world.movement.MovableSprite;
 import com.bartlomiejpluta.base.engine.world.object.Sprite;
 import com.bartlomiejpluta.base.util.math.Distance;
 import lombok.EqualsAndHashCode;
@@ -88,6 +88,11 @@ public abstract class LocationableSprite extends Sprite implements Locationable
       adjustPosition();
    }
 
+   @Override
+   public Direction getDirectionTowards(Locationable target) {
+      return Direction.ofVector(target.getCoordinates().sub(getCoordinates(), new Vector2i()));
+   }
+
    @Override
    public int chebyshevDistance(Vector2ic coordinates) {
       return Distance.chebyshev(this.coordinates, coordinates);
@@ -97,4 +102,14 @@ public abstract class LocationableSprite extends Sprite implements Locationable
    public int manhattanDistance(Vector2ic coordinates) {
       return Distance.manhattan(this.coordinates, coordinates);
    }
+
+   @Override
+   public int chebyshevDistance(Locationable other) {
+      return Distance.chebyshev(this.coordinates, other.getCoordinates());
+   }
+
+   @Override
+   public int manhattanDistance(Locationable other) {
+      return Distance.manhattan(this.coordinates, other.getCoordinates());
+   }
 }

engine/src/main/java/com/bartlomiejpluta/base/engine/world/map/layer/object/DefaultObjectLayer.java

@@ -7,6 +7,7 @@ import com.bartlomiejpluta.base.api.event.Event;
 import com.bartlomiejpluta.base.api.map.layer.object.ObjectLayer;
 import com.bartlomiejpluta.base.api.map.layer.object.PassageAbility;
 import com.bartlomiejpluta.base.api.map.model.GameMap;
+import com.bartlomiejpluta.base.api.move.Movable;
 import com.bartlomiejpluta.base.api.move.Movement;
 import com.bartlomiejpluta.base.api.screen.Screen;
 import com.bartlomiejpluta.base.engine.world.map.layer.base.BaseLayer;
@@ -93,10 +94,12 @@ public class DefaultObjectLayer extends BaseLayer implements ObjectLayer {
                return false;
             }
 
-            // The tile is empty, however another entity is moving on it
-            var otherMovement = entity.getMovement();
-            if (otherMovement != null && otherMovement.getTo().equals(tileCoordinates)) {
-               return false;
+            if (entity instanceof Movable) {
+               // The tile is empty, however another entity is moving on it
+               var otherMovement = ((Movable) entity).getMovement();
+               if (otherMovement != null && otherMovement.getTo().equals(tileCoordinates)) {
+                  return false;
+               }
             }
          }
       }
@@ -140,16 +143,16 @@ public class DefaultObjectLayer extends BaseLayer implements ObjectLayer {
 
    @Override
    public void render(Screen screen, Camera camera, ShaderManager shaderManager) {
-      entities.sort(this::compareObjects);
+      entities.sort(this::compareEntities);
 
-      for (var object : entities) {
-         object.render(screen, camera, shaderManager);
+      for (var entity : entities) {
+         entity.render(screen, camera, shaderManager);
       }
 
       super.render(screen, camera, shaderManager);
    }
 
-   private int compareObjects(Entity a, Entity b) {
+   private int compareEntities(Entity a, Entity b) {
       var z = compare(a.getZIndex(), b.getZIndex());
       return z == 0 ? compare(a.getPosition().y(), b.getPosition().y()) : z;
    }

engine/src/main/resources/application.yml

@@ -5,7 +5,7 @@ app:
     database-script-file: /database/data.sql
 
   sprite:
-    entity:
+    character:
       default-sprite-column: 0
 
       sprite-direction-rows: