docs: format javadoc

2026-04-08 16:56:07 +00:00 · 2024-09-18 13:02:16 +08:00
parent 76f12e0cb8
commit 4bad8f702c
19 changed files with 1 additions and 87 deletions
--- a/platforms/allay/src/main/java/org/allaymc/terra/allay/AllayPlatform.java
+++ b/platforms/allay/src/main/java/org/allaymc/terra/allay/AllayPlatform.java
@@ -20,8 +20,6 @@ import com.dfsek.terra.api.world.biome.PlatformBiome;


 /**
- * Terra Project 2024/6/15
- *
 * @author daoge_cmd
 */
 public class AllayPlatform extends AbstractPlatform {
--- a/platforms/allay/src/main/java/org/allaymc/terra/allay/JeBlockState.java
+++ b/platforms/allay/src/main/java/org/allaymc/terra/allay/JeBlockState.java
@@ -6,14 +6,12 @@ import java.util.TreeMap;


 /**
- * Terra Project 2024/6/16
- *
 * @author daoge_cmd
 */
 public class JeBlockState {
    protected final String identifier;
    protected final TreeMap<String, String> properties;
-    protected int hash = Integer.MAX_VALUE; // 懒加载
+    protected int hash = Integer.MAX_VALUE;

    public static JeBlockState fromString(String data) {
        return new JeBlockState(data);
@@ -63,7 +61,6 @@ public class JeBlockState {
        properties.forEach((k, v) -> builder.append(k).append("=").append(v).append(";"));
        var str = builder.toString();
        if (hash == Integer.MAX_VALUE) {
-            // 顺便算一下hash
            hash = HashUtils.fnv1a_32(str.getBytes());
        }
        return str;
--- a/platforms/allay/src/main/java/org/allaymc/terra/allay/Mapping.java
+++ b/platforms/allay/src/main/java/org/allaymc/terra/allay/Mapping.java
@@ -21,8 +21,6 @@ import java.util.TreeMap;


 /**
- * Terra Project 2024/6/16
- *
 * @author daoge_cmd
 */
@Slf4j
@@ -124,37 +122,6 @@ public final class Mapping {
        return true;
    }

-//    private static BlockState createBeBlockState(Map<String, Object> data) {
-//        var identifier = new Identifier((String) data.get("bedrock_identifier"));
-//        // 方块类型
-//        var blockType = Registries.BLOCKS.get(identifier);
-//        if (blockType == null) {
-//            log.error("Cannot find bedrock block type: {}", identifier);
-//            return BE_AIR_STATE;
-//        }
-//        // 方块属性
-//        Map<String, Object> state = (Map<String, Object>) data.get("state");
-//        if (state == null) return blockType.getDefaultState();
-//        var propertyValues = new BlockPropertyValue<?, ?, ?>[state.size()];
-//        int index = -1;
-//        for(var entry : state.entrySet()) {
-//            index++;
-//            var propertyName = entry.getKey();
-//            var propertyType = blockType.getProperties().get(propertyName);
-//            if (propertyType == null) {
-//                log.warn("Unknown property type: {}", propertyName);
-//                return BlockTypes.AIR.getDefaultState();
-//            }
-//            try {
-//                propertyValues[index] = propertyType.tryCreateValue(entry.getValue());
-//            } catch (IllegalArgumentException e) {
-//                log.warn("Failed to create property value for {}: {}", propertyName, entry.getValue());
-//                return BE_AIR_STATE;
-//            }
-//        }
-//        return blockType.ofState(propertyValues);
-//    }
-
    private static BlockState createBeBlockState(Map<String, Object> data) {
        var builder = NbtMap.builder();
        builder.putString("name", "minecraft:" + data.get("bedrock_identifier"));
--- a/platforms/allay/src/main/java/org/allaymc/terra/allay/TerraAllayPlugin.java
+++ b/platforms/allay/src/main/java/org/allaymc/terra/allay/TerraAllayPlugin.java
@@ -8,8 +8,6 @@ import org.allaymc.terra.allay.generator.AllayGeneratorWrapper;
 import com.dfsek.terra.api.event.events.platform.PlatformInitializationEvent;

 /**
- * Terra Project 2024/6/15
- *
 * @author daoge_cmd
 */
@Slf4j
--- a/platforms/allay/src/main/java/org/allaymc/terra/allay/delegate/AllayBiome.java
+++ b/platforms/allay/src/main/java/org/allaymc/terra/allay/delegate/AllayBiome.java
@@ -4,10 +4,7 @@ import org.allaymc.api.world.biome.BiomeType;

 import com.dfsek.terra.api.world.biome.PlatformBiome;

-
 /**
- * Terra Project 2024/6/16
- *
 * @author daoge_cmd
 */
 public record AllayBiome(BiomeType allayBiome) implements PlatformBiome {
--- a/platforms/allay/src/main/java/org/allaymc/terra/allay/delegate/AllayBlockState.java
+++ b/platforms/allay/src/main/java/org/allaymc/terra/allay/delegate/AllayBlockState.java
@@ -9,10 +9,7 @@ import com.dfsek.terra.api.block.state.properties.Property;

 import java.util.Objects;

-
 /**
- * Terra Project 2024/6/16
- *
 * @author daoge_cmd
 */
 public final class AllayBlockState implements com.dfsek.terra.api.block.state.BlockState {
--- a/platforms/allay/src/main/java/org/allaymc/terra/allay/delegate/AllayBlockType.java
+++ b/platforms/allay/src/main/java/org/allaymc/terra/allay/delegate/AllayBlockType.java
@@ -6,10 +6,7 @@ import org.allaymc.terra.allay.Mapping;

 import com.dfsek.terra.api.block.state.BlockState;

-
 /**
- * Terra Project 2024/6/16
- *
 * @author daoge_cmd
 */
 public record AllayBlockType(BlockType<?> allayBlockType) implements com.dfsek.terra.api.block.BlockType {
--- a/platforms/allay/src/main/java/org/allaymc/terra/allay/delegate/AllayChunk.java
+++ b/platforms/allay/src/main/java/org/allaymc/terra/allay/delegate/AllayChunk.java
@@ -9,10 +9,7 @@ import org.jetbrains.annotations.NotNull;
 import com.dfsek.terra.api.block.state.BlockState;
 import com.dfsek.terra.api.world.ServerWorld;

-
 /**
- * Terra Project 2024/6/16
- *
 * @author daoge_cmd
 */
 public record AllayChunk(ServerWorld world, Chunk allayChunk) implements com.dfsek.terra.api.world.chunk.Chunk {
--- a/platforms/allay/src/main/java/org/allaymc/terra/allay/delegate/AllayEnchantment.java
+++ b/platforms/allay/src/main/java/org/allaymc/terra/allay/delegate/AllayEnchantment.java
@@ -6,10 +6,7 @@ import org.allaymc.terra.allay.Mapping;
 import com.dfsek.terra.api.inventory.ItemStack;
 import com.dfsek.terra.api.inventory.item.Enchantment;

-
 /**
- * Terra Project 2024/6/16
- *
 * @author daoge_cmd
 */
 public record AllayEnchantment(EnchantmentType allayEnchantment) implements Enchantment {
--- a/platforms/allay/src/main/java/org/allaymc/terra/allay/delegate/AllayFakeEntity.java
+++ b/platforms/allay/src/main/java/org/allaymc/terra/allay/delegate/AllayFakeEntity.java
@@ -4,10 +4,7 @@ import com.dfsek.terra.api.entity.Entity;
 import com.dfsek.terra.api.util.vector.Vector3;
 import com.dfsek.terra.api.world.ServerWorld;

-
 /**
- * Terra Project 2024/6/16
- *
 * @author daoge_cmd
 */
 public final class AllayFakeEntity implements Entity {
--- a/platforms/allay/src/main/java/org/allaymc/terra/allay/delegate/AllayItemMeta.java
+++ b/platforms/allay/src/main/java/org/allaymc/terra/allay/delegate/AllayItemMeta.java
@@ -8,12 +8,7 @@ import java.util.Map;
 import com.dfsek.terra.api.inventory.item.Enchantment;
 import com.dfsek.terra.api.inventory.item.ItemMeta;

-
 /**
- * Terra Project 2024/6/16
- *
- * 物品元数据。在allay中物品元数据没有单独的类，故直接使用ItemStack代替
- *
 * @author daoge_cmd
 */
 public record AllayItemMeta(ItemStack allayItemStack) implements ItemMeta {
--- a/platforms/allay/src/main/java/org/allaymc/terra/allay/delegate/AllayItemStack.java
+++ b/platforms/allay/src/main/java/org/allaymc/terra/allay/delegate/AllayItemStack.java
@@ -5,10 +5,7 @@ import org.allaymc.api.item.ItemStack;
 import com.dfsek.terra.api.inventory.Item;
 import com.dfsek.terra.api.inventory.item.ItemMeta;

-
 /**
- * Terra Project 2024/6/16
- *
 * @author daoge_cmd
 */
 public record AllayItemStack(ItemStack allayItemStack) implements com.dfsek.terra.api.inventory.ItemStack{
--- a/platforms/allay/src/main/java/org/allaymc/terra/allay/delegate/AllayItemType.java
+++ b/platforms/allay/src/main/java/org/allaymc/terra/allay/delegate/AllayItemType.java
@@ -4,10 +4,7 @@ import org.allaymc.api.item.type.ItemType;

 import com.dfsek.terra.api.inventory.Item;

-
 /**
- * Terra Project 2024/6/16
- *
 * @author daoge_cmd
 */
 public final class AllayItemType implements Item {
--- a/platforms/allay/src/main/java/org/allaymc/terra/allay/delegate/AllayProtoChunk.java
+++ b/platforms/allay/src/main/java/org/allaymc/terra/allay/delegate/AllayProtoChunk.java
@@ -9,10 +9,7 @@ import org.jetbrains.annotations.NotNull;
 import com.dfsek.terra.api.block.state.BlockState;
 import com.dfsek.terra.api.world.chunk.generation.ProtoChunk;

-
 /**
- * Terra Project 2024/6/16
- *
 * @author daoge_cmd
 */
 public record AllayProtoChunk(UnsafeChunk allayChunk) implements ProtoChunk {
--- a/platforms/allay/src/main/java/org/allaymc/terra/allay/delegate/AllayProtoWorld.java
+++ b/platforms/allay/src/main/java/org/allaymc/terra/allay/delegate/AllayProtoWorld.java
@@ -18,8 +18,6 @@ import com.dfsek.terra.api.world.chunk.generation.ChunkGenerator;
 import com.dfsek.terra.api.world.chunk.generation.ProtoWorld;

 /**
- * Terra Project 2024/6/16
- *
 * @author daoge_cmd
 */
 public record AllayProtoWorld(AllayServerWorld allayServerWorld, OtherChunkAccessibleContext context) implements ProtoWorld {
--- a/platforms/allay/src/main/java/org/allaymc/terra/allay/delegate/AllayServerWorld.java
+++ b/platforms/allay/src/main/java/org/allaymc/terra/allay/delegate/AllayServerWorld.java
@@ -18,10 +18,7 @@ import com.dfsek.terra.api.world.biome.generation.BiomeProvider;
 import com.dfsek.terra.api.world.chunk.Chunk;
 import com.dfsek.terra.api.world.chunk.generation.ChunkGenerator;

-
 /**
- * Terra Project 2024/6/16
- *
 * @author daoge_cmd
 */
 public record AllayServerWorld(AllayGeneratorWrapper allayGeneratorWrapper, Dimension allayDimension) implements ServerWorld {
--- a/platforms/allay/src/main/java/org/allaymc/terra/allay/generator/AllayGeneratorWrapper.java
+++ b/platforms/allay/src/main/java/org/allaymc/terra/allay/generator/AllayGeneratorWrapper.java
@@ -23,10 +23,7 @@ import com.dfsek.terra.api.world.chunk.generation.ChunkGenerator;
 import com.dfsek.terra.api.world.chunk.generation.util.GeneratorWrapper;
 import com.dfsek.terra.api.world.info.WorldProperties;

-
 /**
- * Terra Project 2024/6/16
- *
 * @author daoge_cmd
 */
@Slf4j
--- a/platforms/allay/src/main/java/org/allaymc/terra/allay/handle/AllayItemHandle.java
+++ b/platforms/allay/src/main/java/org/allaymc/terra/allay/handle/AllayItemHandle.java
@@ -13,10 +13,7 @@ import com.dfsek.terra.api.handle.ItemHandle;
 import com.dfsek.terra.api.inventory.Item;
 import com.dfsek.terra.api.inventory.item.Enchantment;

-
 /**
- * Terra Project 2024/6/16
- *
 * @author daoge_cmd
 */
 public class AllayItemHandle implements ItemHandle {
--- a/platforms/allay/src/main/java/org/allaymc/terra/allay/handle/AllayWorldHandle.java
+++ b/platforms/allay/src/main/java/org/allaymc/terra/allay/handle/AllayWorldHandle.java
@@ -9,10 +9,7 @@ import com.dfsek.terra.api.block.state.BlockState;
 import com.dfsek.terra.api.entity.EntityType;
 import com.dfsek.terra.api.handle.WorldHandle;

-
 /**
- * Terra Project 2024/6/16
- *
 * @author daoge_cmd
 */
 public class AllayWorldHandle implements WorldHandle {