Guía para creadores

Funciones gratis para tu juego

Tu juego en Playmurra ya las trae: tabla de puntajes, guardar la partida, logros, multijugador y vender objetos con gemas. Sólo escribes una línea de código para usar cada una.

Todo juego en Playmurra trae el kit window.Playmurra (lo pone Somurra sola, no hay que instalar nada): Playmurra.puntaje(n) para la tabla de puntajes, Playmurra.guardar(datos) / Playmurra.cargar() para guardar la partida en la nube, Playmurra.logro('id', 'Nombre') para logros, Playmurra.sala() para multijugador en tiempo real, Playmurra.comprar('codigo') para vender objetos con gemas (el creador se queda con el 75 %), y Playmurra.anuncio({ premio: true }) para dar una vida o una moneda a cambio de ver un anuncio (sólo en juegos gratis: el creador gana una parte de lo que dejan). Fuera de Somurra no falla: guarda en el navegador y lo demás responde vacío.

Cómo se usa

No instalas nada: en Playmurra tu juego ya tiene window.Playmurra. Si lo pruebas fuera, agrega <script src="https://somurra.com/playmurra-kit.js"></script>.

// 1. Puntajes: al terminar una partida.
Playmurra.puntaje(1250).then((r) => console.log('Tu puesto:', r.puesto))

// 2. Guardar y cargar la partida (en la nube si hay cuenta; si no, en el navegador).
await Playmurra.guardar({ nivel: 3, vidas: 2 })
const partida = await Playmurra.cargar()   // { nivel: 3, vidas: 2 } o null

// 3. Logros: sale un aviso en Somurra la primera vez.
Playmurra.logro('primer-jefe', 'Venciste al primer jefe')

// 4. Multijugador: todos los que abren la misma sala se ven.
const sala = Playmurra.sala()            // o Playmurra.sala('amigos-de-ana')
sala.on('mover', (datos, de) => moverJugador(de.id, datos.x, datos.y))
sala.jugadores((lista) => pintarJugadores(lista))   // [{ id, nombre }]
sala.enviar('mover', { x: 10, y: 20 })

// 5. Vender un objeto (lo das de alta en la página de tu juego, con su código).
const r = await Playmurra.comprar('traje-rojo').catch(() => null)  // Somurra pide confirmar
if (r?.ok) ponerTrajeRojo()
const mios = await Playmurra.objetos()   // ['traje-rojo', ...]

// 6. ¿Quién juega?
const { usuario } = await Playmurra.listo()   // { nombre } o null

// 7. Juego de pago con demo hasta un nivel: avisa al empezar cada nivel.
const { permitido } = await Playmurra.nivel(4)   // false: se acabó la demo y Somurra ofrece comprarlo
const lic = await Playmurra.licencia()            // { dePago, tiene, vence, demo }

// 8. Anuncio con premio (sólo juegos gratis): da la vida SOLO si lo vio entero.
const { visto } = await Playmurra.anuncio({ premio: true })
if (visto) darUnaVida()
await Playmurra.pausa()   // opcional: un anuncio entre niveles, sin premio

Anuncios con premio (solo juegos gratis): ganas una parte de lo que dejan

Pon un botón como «Ver un anuncio para revivir» y llama Playmurra.anuncio({ premio: true }). Somurra le pregunta a quien juega si lo quiere ver; si lo ve completo responde { visto: true } y tu juego da el premio. Entre niveles puedes usar Playmurra.pausa(), sin premio. Cada mes se reparte entre los creadores una parte de lo que pagó la publicidad de los juegos, según cuántos anuncios se vieron completos en cada uno, y llega a tu saldo. Tus propias partidas no cuentan. En las estadísticas de tu juego (Mi biblioteca) ves cuántos se vieron y cuánto llevas. En los juegos de pago no hay anuncios, ni en la demo.

Lo que hay que saber

• Los puntajes cuentan con cuenta de Somurra; uno cada 3 segundos como mucho. Un puntaje más alto es mejor.
• Guardado: hasta 10 ranuras por juego y 200 KB cada una.
• Multijugador: hasta 30 mensajes por segundo y 8 KB cada uno. Somurra no guarda los mensajes: sólo los reparte.
• Objetos: cosméticos o ventajas conocidas de antemano. Nada de cajas sorpresa ni premios al azar. Precio de 10 a 1.000 gemas.
• Juegos de pago: la demo dura unos minutos o llega hasta un nivel (lo eliges al subirlo). Con demo por nivel, tu juego tiene que llamar a Playmurra.nivel(n). Quien lo compra lo juega completo 7 años desde su cuenta; tú recibes el 75 % de lo que queda después de la pasarela.
• Anuncios con premio (solo juegos gratis): ganas una parte de lo que dejan. Somurra le pregunta a quien juega si quiere ver un anuncio corto; si lo ve entero, Playmurra.anuncio({ premio: true }) responde { visto: true } y tu juego da el premio. Uno por minuto como mucho (y 20 por hora por persona). Ofrécelo cuando el jugador lo pida (botón «ver anuncio para revivir»), nunca a la fuerza. Cada mes, una parte (por ahora la mitad) de lo que AdSense le paga a Somurra por los anuncios de los juegos se reparte entre los creadores según cuántos anuncios se vieron completos en cada juego, y va a tu saldo. En un juego de pago no hay anuncios: responde { visto: false, motivo: "juego_de_pago" }.
• En el celular, si tu juego es de teclado, Somurra pone flechas y dos botones (Espacio y Enter) que mandan las teclas de verdad.

¿Tu juego lo hace una IA? Dile «usa el kit de Playmurra» y pásale esta página, o dale tu llave para que lo publique ella misma.