Card templating

admin_panel/bd_models/admin/__init__.py

@@ -1,4 +1,4 @@
-from .ball import BallAdmin, EconomyAdmin, RegimeAdmin
+from .ball import BallAdmin, CardTemplateAdmin, EconomyAdmin, RegimeAdmin
 from .ball_instance import BallInstanceAdmin
 from .guild import GuildAdmin
 from .player import PlayerAdmin
@@ -13,5 +13,6 @@
     "GuildAdmin",
     "PlayerAdmin",
     "SpecialAdmin",
+    "CardTemplateAdmin",
     "TradeAdmin",
 ]

admin_panel/bd_models/admin/ball.py

@@ -8,7 +8,15 @@
 from django.utils.safestring import mark_safe
 from django.utils.text import capfirst
 
-from ..models import Ball, BallInstance, Economy, Regime, TradeObject, transform_media
+from ..models import (
+    Ball,
+    BallInstance,
+    CardTemplate,
+    Economy,
+    Regime,
+    TradeObject,
+    transform_media,
+)
 
 if TYPE_CHECKING:
     from django.db.models import Field, Model, QuerySet
@@ -81,6 +89,12 @@ def icon_image(self, obj: Economy):
         return mark_safe(f'<img src="/media/{transform_media(str(obj.icon))}" height=30px />')
 
 
+@admin.register(CardTemplate)
+class CardTemplateAdmin(admin.ModelAdmin):
+    list_display = ("name", "pk")
+    search_fields = ("name",)
+
+
 @admin.register(Ball)
 class BallAdmin(admin.ModelAdmin):
     autocomplete_fields = ("regime", "economy")

admin_panel/bd_models/admin/special.py

@@ -33,7 +33,7 @@ class SpecialAdmin(admin.ModelAdmin):
         (
             "Advanced",
             {
-                "fields": ["tradeable", "hidden"],
+                "fields": ["tradeable", "hidden", "card_template"],
                 "classes": ["collapse"],
             },
         ),

admin_panel/bd_models/migrations/0008_cardtemplate_alter_ball_options_and_more.py

@@ -0,0 +1,71 @@
+# Generated by Django 5.1.4 on 2025-07-20 21:12
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("bd_models", "0007_player_trade_cooldown_policy"),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="CardTemplate",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
+                    ),
+                ),
+                ("name", models.CharField(max_length=64)),
+                ("template", models.JSONField(help_text="Card template JSON")),
+            ],
+            options={
+                "verbose_name_plural": "card templates",
+                "db_table": "cardtemplate",
+                "managed": True,
+            },
+        ),
+        migrations.AlterModelOptions(
+            name="ball",
+            options={
+                "managed": True,
+                "verbose_name": "countryball",
+                "verbose_name_plural": "countryballs",
+            },
+        ),
+        migrations.AlterModelOptions(
+            name="ballinstance",
+            options={"managed": True, "verbose_name": "countryball instance"},
+        ),
+        migrations.AlterField(
+            model_name="ball",
+            name="country",
+            field=models.CharField(max_length=48, unique=True, verbose_name="Name"),
+        ),
+        migrations.AddField(
+            model_name="regime",
+            name="card_template",
+            field=models.ForeignKey(
+                blank=True,
+                help_text="Card template to use",
+                null=True,
+                on_delete=django.db.models.deletion.SET_NULL,
+                to="bd_models.cardtemplate",
+            ),
+        ),
+        migrations.AddField(
+            model_name="special",
+            name="card_template",
+            field=models.ForeignKey(
+                blank=True,
+                help_text="Card template to use",
+                null=True,
+                on_delete=django.db.models.deletion.SET_NULL,
+                to="bd_models.cardtemplate",
+            ),
+        ),
+    ]

admin_panel/bd_models/models.py

@@ -123,10 +123,32 @@ class Meta:
         verbose_name_plural = "economies"
 
 
+class CardTemplate(models.Model):
+    name = models.CharField(max_length=64)
+    template = models.JSONField(help_text="Card template JSON")
+
+    def __str__(self) -> str:
+        return self.name
+
+    class Meta:
+        managed = True
+        db_table = "cardtemplate"
+        verbose_name_plural = "card templates"
+
+
 class Regime(models.Model):
     name = models.CharField(max_length=64)
     background = models.ImageField(max_length=200, help_text="1428x2000 PNG image")
 
+    card_template = models.ForeignKey(
+        CardTemplate,
+        on_delete=models.SET_NULL,
+        blank=True,
+        null=True,
+        help_text="Card template to use",
+    )
+    card_template_id: int | None
+
     def __str__(self) -> str:
         return self.name
 
@@ -169,6 +191,15 @@ class Special(models.Model):
         max_length=64, help_text="Author of the special event artwork", null=True
     )
 
+    card_template = models.ForeignKey(
+        CardTemplate,
+        on_delete=models.SET_NULL,
+        blank=True,
+        null=True,
+        help_text="Card template to use",
+    )
+    card_template_id: int | None
+
     def __str__(self) -> str:
         return self.name
 
@@ -249,7 +280,6 @@ def save(
         using: str | None = None,
         update_fields: Iterable[str] | None = None,
     ) -> None:
-
         def lower_catch_names(names: str | None) -> str | None:
             if names:
                 return ";".join([x.strip() for x in names.split(";")]).lower()

admin_panel/preview/utils.py

@@ -5,10 +5,12 @@
 from ballsdex.__main__ import init_tortoise
 from ballsdex.core.models import (
     Ball,
+    CardTemplate,
     Economy,
     Regime,
     Special,
     balls,
+    card_templates,
     economies,
     regimes,
     specials,
@@ -40,3 +42,7 @@ async def refresh_cache():
     specials.clear()
     for special in await Special.all():
         specials[special.pk] = special
+
+    card_templates.clear()
+    for card_template in await CardTemplate.all():
+        card_templates[card_template.pk] = card_template

ballsdex/core/bot.py

@@ -30,10 +30,12 @@
     Ball,
     BlacklistedGuild,
     BlacklistedID,
+    CardTemplate,
     Economy,
     Regime,
     Special,
     balls,
+    card_templates,
     economies,
     regimes,
     specials,
@@ -153,8 +155,8 @@ def __init__(
 
         if settings.prometheus_enabled:
             trace = aiohttp.TraceConfig()
-            trace.on_request_start.append(on_request_start)
-            trace.on_request_end.append(on_request_end)
+            trace.on_request_start.append(on_request_start)  # pyright: ignore[reportArgumentType]
+            trace.on_request_end.append(on_request_end)  # pyright: ignore[reportArgumentType]
             options["http_trace"] = trace
 
         super().__init__(command_prefix, intents=intents, tree_cls=CommandTree, **options)
@@ -240,6 +242,11 @@ async def load_cache(self):
             specials[special.pk] = special
         table.add_row("Special events", str(len(specials)))
 
+        card_templates.clear()
+        for card_template in await CardTemplate.all():
+            card_templates[card_template.pk] = card_template
+        table.add_row("Card Templates", str(len(card_templates)))
+
         self.blacklist = set()
         for blacklisted_id in await BlacklistedID.all().only("discord_id"):
             self.blacklist.add(blacklisted_id.discord_id)