Flutter随机数生成插件randpg的使用

Flutter随机数生成插件randpg的使用

介绍

randpg 是一个用于生成各种随机实体的Flutter插件，特别适用于角色扮演游戏（RPG）和幻想游戏。它可以生成从名字、NPC、同伴到整个世界的各种内容。许多功能可以扩展，例如添加其他种族或类型的定居点，以补充现有的类型。

注意： 该插件仍在开发中，某些版本可能在1.0.0之前不向后兼容。

安装

要安装 randpg 插件，请按照以下步骤操作：

1. 打开 pubspec.yaml 文件。
2. 在 dependencies 部分添加 randpg：

   dependencies:
     randpg: ^最新版本号
   

3. 保存文件并运行 flutter pub get 以获取依赖项。

功能

randpg 提供了以下功能：

• 为不同种族生成名字
• 生成NPC
• 生成同伴
• 生成定居点内的地点和建筑物
• 生成定居点
• 生成景观
• 生成神祇
• 生成公会
• 生成王国
• 生成节日
• 生成徽章（SVG格式）
• 生成完整的世界
• 生成世界地图

使用示例

1. 生成名字

import 'package:randpg/randpg.dart';

void main() {
  final Gender gender = Gender.male;
  final Race race = Halfling();
  final nameGenerator = race.getNameGenerator(gender);

  // 如果你想设置生成器的种子：
  nameGenerator.seed(1234);

  print(nameGenerator.generate()); // 预期输出: "Cormin Copperbrook"
}

2. 生成NPC

import 'package:randpg/randpg.dart';

void main() {
  final Race race = Elf();
  final npcGenerator = NpcGenerator(race);

  print(npcGenerator.generate());
}

3. 生成地点/建筑物

import 'package:randpg/randpg.dart';

void main() {
  final LocationType locationType = Tavern();
  final Race ownerRace = Dwarf();

  final locationGenerator = LocationGenerator(locationType, ownerRace);
  print(locationGenerator.generate());
}

4. 生成定居点

import 'package:randpg/randpg.dart';

void main() {
  final SettlementType settlementType = Town();
  final Race dominantRace = Orc();

  final settlementGenerator = SettlementGenerator(settlementType, dominantRace);
  print(settlementGenerator.generate());
}

5. 生成景观

import 'package:randpg/randpg.dart';

void main() {
  final LandscapeType landscapeType = Swamp();

  final landscapeGenerator = LandscapeGenerator(landscapeType);
  print(landscapeGenerator.generate());
}

6. 生成神祇

import 'package:randpg/randpg.dart';

void main() {
  final Alignment alignment = Alignment(
    ethical: EthicalAlignment.lawful,
    moral: MoralAlignment.good,
  );
  final DeityType deityType = God();

  final deityGenerator = DeityGenerator(deityType, alignment);
  print(deityGenerator.generate());
}

7. 生成公会

import 'package:randpg/randpg.dart';

void main() {
  final GuildType guildType = ThievesGuild();
  final guildGenerator = GuildGenerator(guildType);

  final Guild guild = guildGenerator.generate();
  print(guild);
}

8. 生成王国

import 'package:randpg/randpg.dart';

void main() {
  final GovernmentType governmentType = Republic();
  final Race race = Dwarf();
  final KingdomType kingdomType = DefaultKingdomType();

  final Kingdom kingdom = KingdomGenerator(kingdomType, race, governmentType).generate();
  print(kingdom);
}

9. 生成徽章

import 'package:randpg/randpg.dart';

void main() {
  final EmblemType type = DefaultEmblemType();
  final emblemGenerator = EmblemGenerator(type);

  emblemGenerator.seed(3979);

  final Emblem emblem = emblemGenerator.generate();
  print(emblem.buildSvg());
}

10. 生成世界

import 'package:randpg/randpg.dart';

void main() {
  final WorldSettings settings = DefaultWorldSettings();
  final worldGenerator = WorldGenerator(settings);

  final World world = worldGenerator.generate();
  print(world);
}

11. 生成同伴

import 'package:randpg/randpg.dart';

void main() {
  final CompanionType companionType = Dog();
  final Gender gender = Gender.female;
  final companionGenerator = CompanionGenerator(companionType, gender);

  print(companionGenerator.generate());
}

12. 生成节日

import 'package:randpg/randpg.dart';

void main() {
  final HolidayType holidayType = Celebration();
  final holidayGenerator = HolidayGenerator(holidayType);

  print(holidayGenerator.generate());
}

13. 生成世界地图

import 'package:randpg/randpg.dart';

void main() {
  final WorldMapSettings worldMapSettings = IslandsWorldMapSettings();
  final worldMapGenerator = WorldMapGenerator(worldMapSettings, 100, 100);
  worldMapGenerator.seed(1664);

  final worldMap = worldMapGenerator.generate();
  print(worldMap.toMap()["image"]); // 打印图像的base64编码
}

14. 生成带瓦片的世界地图（实验性）

import 'package:randpg/randpg.dart';

void main() {
  final WorldMapSettings worldMapSettings = IslandsWorldMapSettings();
  final worldMapGenerator = WorldMapGenerator.withTiles(worldMapSettings, 16 * 100, 16 * 100); // 16是瓦片大小
  worldMapGenerator.seed(1664);

  final worldMap = worldMapGenerator.generate(); // 注意：此方法目前是实验性的，可能会抛出`UnimplementedError`
  print(worldMap.toMap()["image"]); // 打印图像的base64编码
}