Merge pull request #4 from anhgelus/feat/config

[Feat] Config file

5 files changed, 464 insertions, 42 deletions

diff --git a/src/main/java/world/anhgelus/molehunt/Game.java b/src/main/java/world/anhgelus/molehunt/Game.java
index b116b72..dbe7ebd 100644
--- a/src/main/java/world/anhgelus/molehunt/Game.java
+++ b/src/main/java/world/anhgelus/molehunt/Game.java
@@ -18,8 +18,8 @@ import java.util.stream.Collectors;
 public class Game {

 

     private Timer timer = new Timer();

-    public final static int DEFAULT_TIME = 90*60; // 1:30

-    private int remaining = DEFAULT_TIME;

+    public final int defaultTime = Molehunt.CONFIG.getGameDuration()*60;

+    private int remaining = defaultTime;

 

     private final MinecraftServer server;

 

@@ -34,11 +34,14 @@ public class Game {
     }

 

     public void start() {

-        if (started) return;

-        final int n = (server.getCurrentPlayerCount() - server.getCurrentPlayerCount() % 4)/4;

+        final int n = Molehunt.CONFIG.getMoleCount() < 0

+                ? Math.floorDiv(server.getCurrentPlayerCount(), Math.floorDiv(100, Molehunt.CONFIG.getMolePercentage()))

+                : Molehunt.CONFIG.getMoleCount();

+

         final var playerManager = server.getPlayerManager();

+

         final var players = new ArrayList<>(playerManager.getPlayerList());

-        for (int i = 0; i < n; i++) {

+        for (int i = 0; i < n && !players.isEmpty(); i++) {

             final var r = ThreadLocalRandom.current().nextInt(0, players.size());

             final var mole = players.get(r);

             if (mole == null) throw new IllegalStateException("Mole is null!");

@@ -54,7 +57,7 @@ public class Game {
         gamerules.get(GameRules.DO_IMMEDIATE_RESPAWN).set(true, server);

         gamerules.get(GameRules.DO_ENTITY_DROPS).set(false, server);

 

-        final var title = new TitleS2CPacket(Text.of("§eYou are..."));

+        final var title = new TitleS2CPacket(Text.translatable("molehunt.game.start.suspense"));

         playerManager.getPlayerList().forEach(p -> {

             p.kill();

             p.networkHandler.sendPacket(timing);

@@ -70,10 +73,10 @@ public class Game {
                 playerManager.getPlayerList().forEach(p -> {

                     p.networkHandler.sendPacket(timing);

                     if (moles.contains(p)) {

-                        p.networkHandler.sendPacket(new TitleS2CPacket(Text.of("§cThe Mole!")));

-                        p.networkHandler.sendPacket(new SubtitleS2CPacket(Text.of("§6get the list of moles with /molehunt moles")));

+                        p.networkHandler.sendPacket(new TitleS2CPacket(Text.translatable("molehunt.game.start.mole.title")));

+                        p.networkHandler.sendPacket(new SubtitleS2CPacket(Text.translatable("molehunt.game.start.mole.subtitle")));

                     } else {

-                        p.networkHandler.sendPacket(new TitleS2CPacket(Text.of("§aNot the Mole!")));

+                        p.networkHandler.sendPacket(new TitleS2CPacket(Text.translatable("molehunt.game.start.survivor")));

                     }

                     // reset health and food level

                     p.setHealth(p.getMaxHealth());

@@ -86,32 +89,27 @@ public class Game {
                 // reset time and weather

                 server.getOverworld().setTimeOfDay(0);

                 server.getOverworld().resetWeather();

-

                 started = true;

 

                 timer.scheduleAtFixedRate(new TimerTask() {

                     @Override

                     public void run() {

                         remaining--;

-                        playerManager.sendToAll(timing);

-

                         playerManager.getPlayerList().forEach(player -> {

                             if (Molehunt.timerVisibility.getOrDefault(player, true)) {

                                 player.networkHandler.sendPacket(new OverlayMessageS2CPacket(Text.of(getShortRemainingText())));

                             }

                         });

-

-                        if (remaining == 0) {

-                            end();

-                        }

+                        playerManager.sendToAll(timing);

+                        if (remaining == 0) end();

                     }

-                }, 4*1000, 1000);

+                }, 5*1000, 1000);

             }

         }, 4*1000);

     }

 

     public void stop() {

-        server.getPlayerManager().broadcast(Text.of("Game stopped"), false);

+        server.getPlayerManager().broadcast(Text.translatable("commands.molehunt.stop.success"), false);

         end();

     }

 

@@ -120,7 +118,7 @@ public class Game {
         timer = new Timer();

         started = false;

         final var pm = server.getPlayerManager();

-        final var winnerSuspense = new TitleS2CPacket(Text.of("§eAnd the winners are..."));

+        final var winnerSuspense = new TitleS2CPacket(Text.translatable("molehunt.game.end.suspense.title"));

         pm.getPlayerList().forEach(p -> {

             p.networkHandler.sendPacket(timing);

             p.networkHandler.sendPacket(winnerSuspense);

@@ -131,25 +129,20 @@ public class Game {
             public void run() {

                 TitleS2CPacket winner;

                 if (gameWonByMoles()) {

-                    winner = new TitleS2CPacket(Text.of("§cThe Moles!"));

+                    winner = new TitleS2CPacket(Text.translatable("molehunt.game.end.winners.moles.title"));

                 } else {

-                    winner = new TitleS2CPacket(Text.of("§aNot the Mole!"));

+                    winner = new TitleS2CPacket(Text.translatable("molehunt.game.end.winners.survivors.title"));

                 }

-                pm.sendToAll(new SubtitleS2CPacket(Text.of("§6The Moles were " + getMolesAsString())));

+                pm.sendToAll(new SubtitleS2CPacket(Text.translatable("molehunt.game.end.winners.subtitle")

+                        .append(" " + getMolesAsString()))

+                );

                 pm.sendToAll(winner);

                 pm.sendToAll(timing);

+                moles.clear();

             }

         }, 4*1000);

     }

 

-    public int getRemaining() {

-        return remaining;

-    }

-

-    public Text getRemainingText() {

-        return Text.of("Time remaining: "+ TimeUtils.printTime(remaining));

-    }

-

     public Text getShortRemainingText() {

         return Text.of("§c" + TimeUtils.printShortTime(remaining));

     }

diff --git a/src/main/java/world/anhgelus/molehunt/Molehunt.java b/src/main/java/world/anhgelus/molehunt/Molehunt.java
index 5273b21..d7c0d58 100644
--- a/src/main/java/world/anhgelus/molehunt/Molehunt.java
+++ b/src/main/java/world/anhgelus/molehunt/Molehunt.java
@@ -1,18 +1,29 @@
 package world.anhgelus.molehunt;
 
 import com.mojang.brigadier.Command;
+import com.mojang.brigadier.exceptions.SimpleCommandExceptionType;
 import net.fabricmc.api.ModInitializer;
 import net.fabricmc.fabric.api.command.v2.CommandRegistrationCallback;
 import net.fabricmc.fabric.api.entity.event.v1.ServerLivingEntityEvents;
 import net.fabricmc.fabric.api.entity.event.v1.ServerPlayerEvents;
+import net.fabricmc.fabric.api.event.lifecycle.v1.ServerLifecycleEvents;
+import net.fabricmc.fabric.api.gamerule.v1.GameRuleFactory;
+import net.fabricmc.fabric.api.gamerule.v1.GameRuleRegistry;
 import net.fabricmc.fabric.api.message.v1.ServerMessageEvents;
+import net.fabricmc.fabric.api.networking.v1.PayloadTypeRegistry;
+import net.fabricmc.fabric.api.networking.v1.ServerPlayConnectionEvents;
+import net.fabricmc.fabric.api.networking.v1.ServerPlayNetworking;
 import net.minecraft.network.packet.s2c.play.OverlayMessageS2CPacket;
 import net.minecraft.server.command.ServerCommandSource;
 import net.minecraft.server.network.ServerPlayerEntity;
-import net.minecraft.text.Text;
+import net.minecraft.text.*;
 import net.minecraft.world.GameMode;
+import net.minecraft.world.GameRules;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
+import world.anhgelus.molehunt.config.Config;
+import world.anhgelus.molehunt.config.ConfigPayload;
+import world.anhgelus.molehunt.config.SimpleConfig;
 
 import java.util.HashMap;
 
@@ -23,6 +34,50 @@ public class Molehunt implements ModInitializer {
 
     public static final String MOD_ID = "molehunt";
     public static final Logger LOGGER = LoggerFactory.getLogger(MOD_ID);
+    public static Config CONFIG;
+
+    public static final SimpleConfig CONFIG_FILE = Config.configFile(MOD_ID);
+
+    public static final GameRules.Key<GameRules.IntRule> GAME_DURATION = GameRuleRegistry.register(
+            MOD_ID +":gameDuration",
+            GameRules.Category.MISC,
+            GameRuleFactory.createIntRule(CONFIG_FILE.getOrDefault("game_duration", 90))
+    );
+    public static final GameRules.Key<GameRules.IntRule> MOLE_PERCENTAGE = GameRuleRegistry.register(
+            MOD_ID +":molePercentage",
+            GameRules.Category.MISC,
+            GameRuleFactory.createIntRule(CONFIG_FILE.getOrDefault("mole_percentage", 25))
+    );
+    public static final GameRules.Key<GameRules.IntRule> MOLE_COUNT = GameRuleRegistry.register(
+            MOD_ID +":moleCount",
+            GameRules.Category.MISC,
+            GameRuleFactory.createIntRule(CONFIG_FILE.getOrDefault("mole_count", -1))
+    );
+    public static final GameRules.Key<GameRules.BooleanRule> SHOW_NAMETAGS = GameRuleRegistry.register(
+            MOD_ID +":showNametags",
+            GameRules.Category.MISC,
+            GameRuleFactory.createBooleanRule(CONFIG_FILE.getOrDefault("show_nametags", false), (server, val) -> {
+                if (CONFIG == null) return;
+                CONFIG.sendConfigPayload();
+            })
+    );
+    public static final GameRules.Key<GameRules.BooleanRule> SHOW_TAB = GameRuleRegistry.register(
+            MOD_ID +":showTab"
+            , GameRules.Category.MISC,
+            GameRuleFactory.createBooleanRule(CONFIG_FILE.getOrDefault("show_tab", false), (server, val) -> {
+                if (CONFIG == null) return;
+                CONFIG.sendConfigPayload();
+            })
+    );
+    public static final GameRules.Key<GameRules.BooleanRule> SHOW_SKINS = GameRuleRegistry.register(
+            MOD_ID +":showSkins",
+            GameRules.Category.MISC,
+            GameRuleFactory.createBooleanRule(CONFIG_FILE.getOrDefault("show_skins", false), (server, val) -> {
+                if (CONFIG == null) return;
+                CONFIG.sendConfigPayload();
+            })
+    );
+
     public Game game;
 
     public static HashMap<ServerPlayerEntity, Boolean> timerVisibility = new HashMap<>();
@@ -37,20 +92,18 @@ public class Molehunt implements ModInitializer {
             game.start();
             return Command.SINGLE_SUCCESS;
         }));
-//        command.then(literal("time").executes(context -> {
-//            context.getSource().sendFeedback(() -> game.getRemainingText(), false);
-//            return Command.SINGLE_SUCCESS;
-//        }));
         command.then(literal("timer").requires(ServerCommandSource::isExecutedByPlayer).then(
                 literal("show").executes(context -> {
                     timerVisibility.put(context.getSource().getPlayer(), true);
-                    context.getSource().sendFeedback(() -> Text.of("Showing molehunt timer"), false);
+                    context.getSource().sendFeedback(() -> Text.translatable("commands.molehunt.timer.show"), false);
 
                     var player = context.getSource().getPlayer();
                     assert player != null;
 
                     if (game == null || !game.hasStarted()) {
-                        player.networkHandler.sendPacket(new OverlayMessageS2CPacket(Text.of("§cGame has not started yet")));
+                        player.networkHandler.sendPacket(new OverlayMessageS2CPacket(
+                            Text.translatable("commands.molehunt.stop.failed").setStyle(Style.EMPTY.withColor(16733525))
+                        ));
                     } else {
                         player.networkHandler.sendPacket(new OverlayMessageS2CPacket(Text.of(game.getShortRemainingText())));
                     }
@@ -60,18 +113,17 @@ public class Molehunt implements ModInitializer {
         ).then(
                 literal("hide").executes(context -> {
                     timerVisibility.put(context.getSource().getPlayer(), false);
-                    context.getSource().sendFeedback(() -> Text.of("Hiding molehunt timer"), false);
+                    context.getSource().sendFeedback(() -> Text.translatable("commands.molehunt.timer.hide"), false);
                     return Command.SINGLE_SUCCESS;
                 })
         ));
-        command.then(literal("moles").requires(source -> (game != null) && game.isAMole(source.getPlayer())).executes(context -> {
-            context.getSource().sendFeedback(() -> Text.literal("List of moles: " + game.getMolesAsString()),false);
+        command.then(literal("moles").requires(source -> game != null && game.isAMole(source.getPlayer())).executes(context -> {
+            context.getSource().sendFeedback(() -> Text.translatable("commands.molehunt.moles.list").append(" " + game.getMolesAsString()),false);
             return Command.SINGLE_SUCCESS;
         }));
         command.then(literal("stop").requires(source -> source.hasPermissionLevel(1)).executes(context -> {
             if (game == null || !game.hasStarted()) {
-                context.getSource().sendError(Text.of("Game has not started yet"));
-                return Command.SINGLE_SUCCESS;
+                throw (new SimpleCommandExceptionType(Text.translatable("commands.molehunt.stop.failed"))).create();
             }
 
             game.stop();
@@ -79,12 +131,15 @@ public class Molehunt implements ModInitializer {
             return Command.SINGLE_SUCCESS;
         }));
 
+        ServerLifecycleEvents.SERVER_STARTED.register(server -> CONFIG = new Config(server));
+
         CommandRegistrationCallback.EVENT.register((dispatcher, registryAccess, environment) -> dispatcher.register(command));
 
         ServerMessageEvents.ALLOW_CHAT_MESSAGE.register((message, sender, params) -> false);
 
         ServerLivingEntityEvents.AFTER_DEATH.register((entity, damageSource) -> {
             if (!(entity instanceof ServerPlayerEntity) || game == null) return;
+            if (!game.hasStarted()) return;
             if (game.gameWonByMoles()) game.end();
         });
 
@@ -94,5 +149,12 @@ public class Molehunt implements ModInitializer {
             if (game.getMoles().contains(oldPlayer)) game.updateMole(oldPlayer, newPlayer);
             newPlayer.changeGameMode(GameMode.SPECTATOR);
         });
+
+        ServerPlayConnectionEvents.JOIN.register((handler, sender, server) -> ServerPlayNetworking.send(
+                handler.player,
+                new ConfigPayload(CONFIG.areNametagsEnabled(), CONFIG.areSkinsEnabled(), CONFIG.isTabEnabled())
+        ));
+
+        PayloadTypeRegistry.playS2C().register(ConfigPayload.ID, ConfigPayload.CODEC);
     }
 }
diff --git a/src/main/java/world/anhgelus/molehunt/config/Config.java b/src/main/java/world/anhgelus/molehunt/config/Config.java
new file mode 100644
index 0000000..dbaebcf
--- /dev/null
+++ b/src/main/java/world/anhgelus/molehunt/config/Config.java
@@ -0,0 +1,89 @@
+package world.anhgelus.molehunt.config;
+
+import net.fabricmc.fabric.api.networking.v1.ServerPlayNetworking;
+import net.minecraft.server.MinecraftServer;
+import world.anhgelus.molehunt.Molehunt;
+
+public class Config {
+
+    private final MinecraftServer server;
+
+    public Config(MinecraftServer server) {
+        this.server = server;
+
+        sendConfigPayload(areNametagsEnabled(), areSkinsEnabled(), isTabEnabled());
+    }
+
+    public void sendConfigPayload() {
+        final var payload = new ConfigPayload(areNametagsEnabled(), areSkinsEnabled(), isTabEnabled());
+        server.getPlayerManager().getPlayerList().forEach(p -> {
+            ServerPlayNetworking.send(p, payload);
+        });
+    }
+
+    public void sendConfigPayload(boolean showNametags, boolean showSkins, boolean showTab) {
+        final var payload = new ConfigPayload(showNametags, showSkins, showTab);
+        server.getPlayerManager().getPlayerList().forEach(p -> ServerPlayNetworking.send(p, payload));
+    }
+
+    public int getGameDuration() {
+        return server.getGameRules().getInt(Molehunt.GAME_DURATION);
+    }
+
+    public int getMolePercentage() {
+        return server.getGameRules().getInt(Molehunt.MOLE_PERCENTAGE);
+    }
+
+    public int getMoleCount() {
+        return server.getGameRules().getInt(Molehunt.MOLE_COUNT);
+    }
+
+    public boolean areNametagsEnabled() {
+        return server.getGameRules().getBoolean(Molehunt.SHOW_NAMETAGS);
+    }
+
+    public boolean areSkinsEnabled() {
+        return server.getGameRules().getBoolean(Molehunt.SHOW_SKINS);
+    }
+
+    public boolean isTabEnabled() {
+        return server.getGameRules().getBoolean(Molehunt.SHOW_TAB);
+    }
+
+    public static SimpleConfig configFile(String fileName) {
+        return SimpleConfig.of(fileName).provider(Config::defaultConfig).request();
+    }
+
+    private static String defaultConfig(String s) {
+        return """
+                # Molehunt mod configuration file
+
+                # The duration of a molehunt game, in minutes.
+                # Default: 90 minutes (1 hour 30 minutes).
+                game_duration = 90
+                
+                # Mole percentage.
+                # For example, a mole percentage of 25% will get 1 mole every 4 players.
+                # Default: 25 %.
+                mole_percentage = 25
+                
+                # Mole count (absolute).
+                # This setting will overwrite the mole_percentage setting.
+                # If set below 0, this setting is disabled.
+                # Default: -1.
+                mole_count = -1
+                
+                # Show nametags
+                # Default: false
+                show_nametags = false
+                
+                # Show skins
+                # Default: false
+                show_skins = false
+                
+                # Show tab
+                # Default: false
+                show_tab = false
+                """;
+    }
+}
diff --git a/src/main/java/world/anhgelus/molehunt/config/ConfigPayload.java b/src/main/java/world/anhgelus/molehunt/config/ConfigPayload.java
new file mode 100644
index 0000000..0123e74
--- /dev/null
+++ b/src/main/java/world/anhgelus/molehunt/config/ConfigPayload.java
@@ -0,0 +1,25 @@
+package world.anhgelus.molehunt.config;

+

+import net.minecraft.network.RegistryByteBuf;

+import net.minecraft.network.codec.PacketCodec;

+import net.minecraft.network.codec.PacketCodecs;

+import net.minecraft.network.packet.CustomPayload;

+import net.minecraft.util.Identifier;

+import world.anhgelus.molehunt.Molehunt;

+

+public record ConfigPayload(boolean showNametags, boolean showSkins, boolean showTab) implements CustomPayload {

+    public static final Identifier CONFIG_PACKET_ID = Identifier.of(Molehunt.MOD_ID, "config");

+

+    public static final CustomPayload.Id<ConfigPayload> ID = new CustomPayload.Id<>(CONFIG_PACKET_ID);

+    public static final PacketCodec<RegistryByteBuf, ConfigPayload> CODEC = PacketCodec.tuple(

+            PacketCodecs.BOOL, ConfigPayload::showNametags,

+            PacketCodecs.BOOL, ConfigPayload::showSkins,

+            PacketCodecs.BOOL, ConfigPayload::showTab,

+            ConfigPayload::new

+    );

+

+    @Override

+    public Id<? extends CustomPayload> getId() {

+        return ID;

+    }

+}

diff --git a/src/main/java/world/anhgelus/molehunt/config/SimpleConfig.java b/src/main/java/world/anhgelus/molehunt/config/SimpleConfig.java
new file mode 100644
index 0000000..2b65829
--- /dev/null
+++ b/src/main/java/world/anhgelus/molehunt/config/SimpleConfig.java
@@ -0,0 +1,253 @@
+package world.anhgelus.molehunt.config;
+
+/*
+ * Copyright (c) 2021 magistermaks
+ * Slightly modified by Léo-21 and Anhgelus Morhtuuzh
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+import net.fabricmc.loader.api.FabricLoader;
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+
+import java.io.File;
+import java.io.IOException;
+import java.io.PrintWriter;
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.HashMap;
+import java.util.Scanner;
+
+public class SimpleConfig {
+
+    private static final Logger LOGGER = LogManager.getLogger("SimpleConfig");
+    private final HashMap<String, String> config = new HashMap<>();
+    private final ConfigRequest request;
+    private boolean broken = false;
+
+    public interface DefaultConfig {
+        String get( String namespace );
+
+        static String empty( String namespace ) {
+            return "";
+        }
+    }
+
+    public static class ConfigRequest {
+
+        private final File file;
+        private final String filename;
+        private DefaultConfig provider;
+
+        private ConfigRequest(File file, String filename ) {
+            this.file = file;
+            this.filename = filename;
+            this.provider = DefaultConfig::empty;
+        }
+
+        /**
+         * Sets the default config provider, used to generate the
+         * config if it's missing.
+         *
+         * @param provider default config provider
+         * @return current config request object
+         * @see DefaultConfig
+         */
+        public ConfigRequest provider( DefaultConfig provider ) {
+            this.provider = provider;
+            return this;
+        }
+
+        /**
+         * Loads the config from the filesystem.
+         *
+         * @return config object
+         * @see SimpleConfig
+         */
+        public SimpleConfig request() {
+            return new SimpleConfig( this );
+        }
+
+        private String getConfig() {
+            return provider.get( filename ) + "\n";
+        }
+
+    }
+
+    /**
+     * Creates new config request object, ideally `namespace`
+     * should be the name of the mod id of the requesting mod
+     *
+     * @param filename - name of the config file
+     * @return new config request object
+     */
+    public static ConfigRequest of( String filename ) {
+        Path path = FabricLoader.getInstance().getConfigDir();
+        return new ConfigRequest( path.resolve( filename + ".properties" ).toFile(), filename );
+    }
+
+    private void createConfig() throws IOException {
+
+        // try creating missing files
+        request.file.getParentFile().mkdirs();
+        Files.createFile( request.file.toPath() );
+
+        // write default config data
+        PrintWriter writer = new PrintWriter(request.file, StandardCharsets.UTF_8);
+        writer.write( request.getConfig() );
+        writer.close();
+
+    }
+
+    private void loadConfig() throws IOException {
+        Scanner reader = new Scanner( request.file );
+        for( int line = 1; reader.hasNextLine(); line ++ ) {
+            parseConfigEntry( reader.nextLine(), line );
+        }
+    }
+
+    private void parseConfigEntry( String entry, int line ) {
+        if( !entry.isEmpty() && !entry.startsWith( "#" ) ) {
+            String[] parts = entry.split("=", 2);
+            if( parts.length == 2 ) {
+                config.put( parts[0].stripTrailing(), parts[1].strip() );
+            }else{
+                throw new RuntimeException("Syntax error in config file on line " + line + "!");
+            }
+        }
+    }
+
+    private SimpleConfig( ConfigRequest request ) {
+        this.request = request;
+        String identifier = "Config '" + request.filename + "'";
+
+        if( !request.file.exists() ) {
+            LOGGER.info("{} is missing, generating default one...", identifier);
+
+            try {
+                createConfig();
+            } catch (IOException e) {
+                LOGGER.error("{} failed to generate!", identifier);
+                LOGGER.trace( e );
+                broken = true;
+            }
+        }
+
+        if( !broken ) {
+            try {
+                loadConfig();
+            } catch (Exception e) {
+                LOGGER.error("{} failed to load!", identifier);
+                LOGGER.trace( e );
+                broken = true;
+            }
+        }
+
+    }
+
+    /**
+     * Queries a value from config, returns `null` if the
+     * key does not exist.
+     *
+     * @return  value corresponding to the given key
+     * @see     SimpleConfig#getOrDefault
+     */
+    @Deprecated
+    public String get( String key ) {
+        return config.get( key );
+    }
+
+    /**
+     * Returns string value from config corresponding to the given
+     * key, or the default string if the key is missing.
+     *
+     * @return  value corresponding to the given key, or the default value
+     */
+    public String getOrDefault( String key, String def ) {
+        String val = get(key);
+        return val == null ? def : val;
+    }
+
+    /**
+     * Returns integer value from config corresponding to the given
+     * key, or the default integer if the key is missing or invalid.
+     *
+     * @return  value corresponding to the given key, or the default value
+     */
+    public int getOrDefault( String key, int def ) {
+        try {
+            return Integer.parseInt( get(key) );
+        } catch (Exception e) {
+            return def;
+        }
+    }
+
+    /**
+     * Returns boolean value from config corresponding to the given
+     * key, or the default boolean if the key is missing.
+     *
+     * @return  value corresponding to the given key, or the default value
+     */
+    public boolean getOrDefault( String key, boolean def ) {
+        String val = get(key);
+        if( val != null ) {
+            return val.equalsIgnoreCase("true");
+        }
+
+        return def;
+    }
+
+    /**
+     * Returns double value from config corresponding to the given
+     * key, or the default string if the key is missing or invalid.
+     *
+     * @return  value corresponding to the given key, or the default value
+     */
+    public double getOrDefault( String key, double def ) {
+        try {
+            return Double.parseDouble( get(key) );
+        } catch (Exception e) {
+            return def;
+        }
+    }
+
+    /**
+     * If any error occurred during loading or reading from the config
+     * a 'broken' flag is set, indicating that the config's state
+     * is undefined and should be discarded using `delete()`
+     *
+     * @return the 'broken' flag of the configuration
+     */
+    public boolean isBroken() {
+        return broken;
+    }
+
+    /**
+     * deletes the config file from the filesystem
+     *
+     * @return true if the operation was successful
+     */
+    public boolean delete() {
+        LOGGER.warn("Config '{}' was removed from existence! Restart the game to regenerate it.", request.filename);
+        return request.file.delete();
+    }
+
+}
\ No newline at end of file